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RETAIL CATALOGUE 

With this issue of RISC User you will find the latest 
version of our Retail Catalogue containing details 
of Acom related products. We are producing two 
additional catalogues, one on Commodore Amiga 
products, and one on Business products including 
Amstrad PCs PCWs and Fax machines. Please let us 
know if you would like to be put on the mailing list 
to receive either of these. Associated with the new 
catalogue are some fundamental changes to our 
Laid which we believe will improve the service we 
offer. 


We recognise that in the past our members’ prices 
have sometimes been higher than the discounted 
prices offered by some other dealers. Our ability to 
match or even improve on such prices is linked to 
our purchasing power. From now on a single price 
will apply to all customers, which we hope, with 
your support, will enable us to set even better 
prices in the future. Consequently our Retail 
Catalogue will just have one price for all products 
from now on. However, for your convenience we 
will be showing the price both exclusive and 
inclusive of VAT. 


Members will continue to benefit from the 
discounts that we have always offered on our own 
software products. This applies to magazine 
products like ArcScan II and to software products 
like Ovation and Hearsay. Members’ prices on 
these products will be listed each month in the 
magazine. 


It is also our intention to offer members regular 
special offers on selected items. These offers will 
normally be valid only for one month, i.e. until the 
next issue of RISC User arrives. Members’ prices 
and special offers will feature regularly in the 
magazine. 


TECHNICAL SUPPORT 
We have also taken steps to improve the quality 
of help and advice available from our enlarged 


and restructured Technical Support team. Jeffrey 
George is the new manager of this group, and 
technical advice will be available from him and 
team members Graeme Davidson, Gary 
Blackwell, Nathan Brown, and Darren Finch. 
Secretarial and administrative back-up is 
provided by Barbara Oliver. 


Robert Barnes, who was previously Technical 
Manager is now Sales Manager, and team 
member lan MacDougall has moved to Software 
Development managed by John Wallace. 


The new Technical Support team will endeavour 
to deal with all your enquiries more quickly and 
more efficiently than ever before. We will in 
future, concentrate on providing in-depth 
technical advice to members who have queries 
with products they have purchased from us. We 
will also endeavour to provide general help and 
advice so that you may continue to get the best 
use from your system. Regrettably, we cannot 
continue to provide support on products 
purchased from other dealers. Please bear in 
mind, that unlike other magazines and 
organisations, we make no extra charge for the 
help and support which our Technical Support 
team provides. Our Returns and Repairs 
departments have also been supplemented by 
extra staff to improve service here. 


All the changes described above have been 
introduced to ensure that we can continue to 
provide the best service to Archimedes users, in 
general, and to RISC User members in particular. 


BEEBUG OPEN DAY 

We shall be holding an Open Day this year on 
Sunday 7th October, from 10am to 4pm. This 
provides the ideal opportunity to see and try out 
a wide variety of hardware and software, and 
there should be a few bargains to be had as well. 
Further details are included with this issue of 
RISC User. 
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NEW QUMES 


‘A new member of the Qume CrystalPrint 
family of printers has recently been launched. 
Called the CrystalPrint Express, it boasts a 
speed of 12 pages per minute using a Sanyo 
laser engine. It comes with 3 Mbytes of RAM 
expandable to 8 Mbytes. The printer supports 
both PostScript and HP LaserJet emulation, 
and has 39 resident PostScript and 31 
LaserJet fonts. Resolutions of 300x600 dpi 
and 300x300 dpi are supported. The 
CrystalPrint Express costs £4312.50. 


Also recently launched by Qume is the 
CrystalPrint Publisher I], This is an 
updated version of the original Publisher 
(see the review in RISC User Volume 3 
Issue 4). The specifications for the 
Publisher II are much the same as the 
earlier model, except that the printer now 
sports HP LaserJet emulation, in addition 
to PostScript compatibility as before, for the 
same price of £3448.85. 


Further information on all Qume products 
can be obtained from Qume Ltd, Qume 
House, Parkway, Newbury, Berkshire RG13 
1EE, tel. (0635) 523200, fax (0635) 521011. 


PROCESSING WORDS 


Arnor, a company hitherto unknown in the 
Archimedes market, has announced an Arc 
version of Protext, its professional word 
processor. Protext has been successful on 
other computer systems. The Archimedes 
version is claimed to be extremely fast, and 
includes split screen editing, proportional 
font handling, programmable mail merge 
language, index and contents generation, 
newspaper column printing, addition of 
figures by row or column, macros, full 
foreign language support and many other 
professional features. A Collins dictionary of 
over 110,000 words is included, with 
phonetic word suggestion. 


Protext will be available in October and will 
cost £149.95 inc. VAT. Arnor is planning to 
release Arc versions of other successful 
business packages, including its database 
Prodata. The company can be contacted at 
611 Lincoln Road, Peterborough PE1 3HA, 
tel. (0733) 68909. 


EPROM PROGRAMMER 


Racing Car Computers has announced an 
EPROM programmer package for the A3000 
and the 400 series, consisting of a hardware 
programmer unit and controlling software. 
A choice of two units is available: a self- 
powered serial unit which connects via the 
RS232 port, and a parallel unit in the form 
of an expansion card with a small external 
box housing the ZIF socket. The software is 
fully multi-tasking, and can handle 
standard EPROMs from a 2716 to a 27512, 
or user-specified devices. It features a 
powerful hex editor. The cost of the software 
package with either a serial or a parallel 
programmer unit is £149.95 inc. VAT. 
Further details can be obtained from Racing 
Car Computers, 1 Mulberry Cottage, Tye 
Green, Elsenham, Bishop's Stortford, Herts 
CM22 6DZ, tel. (0279) 812496. 


600 DPI LASER PRINTING 


Computer Concepts’ LaserDirect expansion 
board for the Canon LPB-4 print engine, 
first mentioned in Volume 3 Issue 7, will be 
seen in public for the first time at the Acorn 
User Show. Building on the LaserDirect 
technology (see the review in RISC User 
Volume 3 Issue 8), CC has developed a 
board capable of driving the Canon engine 
at a resolution of 600 dpi. This is twice the 
resolution of any other laser printer in the 
domestic and small business market sector, 
and promises print quality for DTP and 
other applications which would previously 
have been out of reach of Archimedes users. 


Also on show will be CC’s PostScript 
compatible interpreter, which when used 
with the LaserDirect will offer all the speed, 
quality and convenience of a PostScript 
printer but will use the Acorn outline fonts. 


The 600 dpi LaserDirect board will cost 
£402.50 inc. VAT. The Canon LPB-4 engine 
is widely available at a RRP of £1506.50. 
For further information, contact Computer 
Concepts, Gaddesden Place, Hemel 
Hempstead HP2 6EX, tel. (0442) 63933. 
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CLARES’ NEWS 


Three new products are available from 
Clares. Rhapsody is a music editor which 
allows you to write and edit music scores, 
output them to a printer, and play them 
either on the Arc’s sound system or through 
a MIDI interface. Music may be entered 
manually or from a MIDI keyboard, and 
Maestro files are also accepted. All the 
usual elements of musical notation are 
supported, and text can also be added, 
giving you the facility to include lyrics. 
Rhapsody costs £49.95 inc. VAT. 


Interdictor 2 is not simply a revised version 
of Interdictor, but is a completely new flight 
simulation game, says Clares. Smoother and 
faster than the original, it claims to be more 
realistic and includes a local situation 
awareness computer (LOCSAC). There is a 
greater variety of other vehicles and craft, 
and enemies have more built-in intelligence. 
Interdictor 2 costs £34.95 inc. VAT. 


Clares has also taken over responsibility for 
Schema, the spreadsheet originally 
announced by Acorn (see News, Volume 3 
Issue 8). Details are much the same as 
described in that issue, although Clares has 
promised some improvements. The price is 
£129.95 inc. VAT. Details of all these and 
other Clares products are available from 
Clares Micro Supplies, 98 Middlewich 
Road, Northwich, Cheshire CW9 7DA, tel. 
(0606) 48511, fax (0606) 48512. 


TECHNOLOGY IN SCOTLAND 


The 4th annual SATRO (Science and 
Technology Regional Organisation) show will 
take place at Aberdeen Music Hall on 9th 
December 1990, from 11.00-17.00. This is an 
important event for computer and science 
enthusiasts in the north of Scotland, and is 
supported by schools, colleges and universities 
as well as other interested groups. Admission 
will cost £1.00 per head, and details can be 
obtained from SATRO North Scotland, 
Marischal College, University of Aberdeen, 
Broad Street, Aberdeen AB9 14S, tel. (0224) 
273161, fax (0224) 273160. 
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TINY DRAW 


Topologika has released a drawing package 
aimed specifically at primary school 
children. Called Tiny Draw, it is claimed to 
be suitable for children of five years old and 
upwards, and allows them to create 
pictures easily via a menu system which is 
accessed through icons and pointers. The 
program features can be turned on or off by 
a special configuration program which 
allows the software to be tailored to 
individual users. Tiny Draw costs £28.75 
inc. VAT and comes with a comprehensive 
Teachers Guide plus a further program 
called Tiny Logo. This is an introduction to 
the Logo language, again designed for the 
very young. Topologika can be contacted at 
PO Box 39, Stilton, Peterborough PE7 3RL, 
tel. (0733) 244682. 


ACCESS YOUR PC 


Minerva has released PC Access, a PC disc 
reader for the Archimedes, Once installed 
on the icon bar, you can read to and write 
from PC format discs, transfer files between 
PC and Arc discs, and also use MS-DOS 
commands such as FORMAT, DIR, 
BACKUP, VERIFY and TYPE. PC Access 
costs £39.95 inc. VAT, and more information 
can be obtained from Minerva Software, 
Minerva House, Baring Crescent, Exeter 
EX1 1TL, tel. (0392) 437756. 


KEEPING ACCOUNT 


Also from Minerva is a suite of accounting 
programs under the title Minerva Business 
Accounts. Modules are available on stock 
management, order processing/invoicing, 
sales ledger, purchase ledger and nominal 
ledger. The modules can be used alone or as 
an integrated suite. Features of the suite 
include definable invoice layouts, stock 
analysis, archiving of customer names and 
addresses, multiple statements by various 
criteria etc. The price is £99.95 inc. VAT per 
module, or £399.95 inc. VAT for the 
complete set of five. Minerva’s address is 
given above. 

RY 


Arxe Systems Ltd 


PO Box 898 (Ref RU) 


Forest Gate, London, E7 9RG 
Tel : 081 534 1198 (eve) 


RFRHE S\'STems LTD. 


MULTIFS 


MultiFS provides the Archimedes with multiple filing system support. 
This new filer allows the user to read and write to non standard 
Archimedes discs from within the desktop enviroment. Current 


formats supported : 


vey MS-DOS 
vx Atari DOS 
ve BBC DFS 


This filer allows access to any hard disc partitions for the PC 
Emulator, and allows the user to treat PC discs in exactly the same 
manner as ADFS discs. 


MultiFS Features 


True Risc OS filer 

Filetypes maintained on DOS discs 
Format and create system discs 
Provides access to DOS partitions 
Supports disc names for DOS 


Site licences available, for furthur 
details please write to the above 
| address. | 


Display 

Select all 
Clear selection 
Options 

New directory 
(pen parent 
Count 


Copy 


Rename ; 


Delete 
Access %) 
Count 


MultiFS is available now, priced at 
£36, including VAT and postage. 
Please make all cheques payable to 
Arxe Systems Ltd. Sorry but no 
credit cards. For further details 
please write to the above address. 


init =) =) 
eh 


Eoonet 


Icon Bar Clock 


Keep track of the passing hours with Mike lronmonger’s timely 


Desktop utility. 


he application [BarClock provides a 
combined digital and analogue clock on 
the icon bar. It is installed in the normal 
fashion, and can be removed by choosing 
the Quit option from its menu. 


Before typing in the program, first 
create a directory called !JBarClock to 
hold all the following files. First, copy into 
it the /Sprites file from the !Clock 
directory on Applications Disc 2 (to avoid 
creating a new sprite for the directory 
viewer we are using the sprite from 
Acorn’s clock), Then type in and run 
Listing 1, SpriteMake. This creates a file 
called Sprites, containing the clock face 
which is used for the icon bar icon, Next, 
create an Obey file using Edit as follows: 

IconSprites <Obey$Dir>.Sprites 

WimpSlot -min 16K -max 16K 

Run <Obey$Dir>. ! RunImage 
and save this as /Run. Finally, type in 
Listing 2 and save this as /RunImage. 


Part of the Desktop showing the Icon Bar Clock 
on the icon bar 


PROGRAM DETAILS 

As you will see when you run the 
program, the clock uses the sprite-and- 
text icon facility which RISC OS makes 
available. One problem with these icons is 
that you cannot specify the address of a 
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user sprite area for the sprite. Instead, 
you have to rely 10 REM >SpriteMake on 
the window’s sprite area pointer, and in 
the case of the icon bar this is the 
Desktop’s sprite pool. The clock face sprite 
is loaded by an IconSprites command in 
the !Run file. 


Another major feature of this and 
other Wimp clock programs is the use of 
the Wimp_Pollldle call. This performs the 
same task as Wimp_Poll, but it also takes 
another parameter that specifies the 
earliest time at which the task wants to 
receive another null reason code. The 
purpose of this is to prevent the Wimp 
sending null reason codes when they are 
not needed. Each time a null reason code 
is received by the program, the displayed 
time is updated, and the “earliest time” 
parameter passed to Wimp_Pollldle is 
increased by one second. Thus, unless the 
Wimp is otherwise engaged, the clock will 
be updated once a second. 


This updating first involves an 
OS_Word call to read the actual time (line 
240). This is then passed to 
OS_ConvertDateAndTime, which converts 
it into a text string which it stores in the 
text buffer of the clock icon. To change the 
hands of the clock, the VDU output is 
switched to the clock face sprite. The 
hands are then cleared (line 330) and re- 
drawn in their new position. A call to 
Wimp_SetlIconState (line 440) then forces 
the changes in both the text and the sprite 
to be reflected on the screen. 


Listing 1 
10 REM >SpriteMake 


20 : 

30 MODE12:ORIGIN 640,512 

40 COLOUR129:CLS:GCOL8 

50 DATA 0, 40,20, 36, 34,20, 40,0 
60 FORP%=0TO3:READ X$,Y% 

70 POINTXt, Y%:DRAW BY 2,0 


Icon Bar Clock 


80 POINTX$, -Y$:DRAW BY 2,0 

90 POINT-X%,Y%:DRAW BY 2,0 

100 POINT-X%,-Y%:DRAW BY 2,0 

110 NEXT 

120 *SNew 

130 SYS "OS_SpriteOp",16,,"clockface", 
,740,-40, 42,40 

140 *SSave $.!IBarClock.Sprites 


Listing 2 
10 REM >!RunImage 
20 REM Program Icon bar clock 
30 REM Version 1.00 


40 REM Author Mike Ironmonger 

50 REM RISC User October 1990 

60 REM Program Subject To Copyright 
10: 


80 PROCinitialise 

90 ON ERROR PROCerror (ERR, REPORTS) 

100 : 

110 REPEAT 

120 SYS “Wimp PollIdle", &81932,block$, 
oldtime$ TO A% 

130 CASE Ai OF 

140 WHEN 0 : PROCupdate hands 

150 WHEN 6 : IF block$!8=2 PROCcreate 
_menu (!block’-64) 

160 WHEN 9 : quit$=(!block%=0) 

170 WHEN 17,18 : quit$=(blockt!16=0) 

180 ENDCASE 

190 UNTIL quit’ 

200 SYS "Wimp CloseDown" 

210 END 

220 ; 

230 DEFPROCupdate_hands 

240 ?blockt=3:SYS “OS Word",14,block$ 

250 SYS "OS ConvertDateAndTime", block? 
,b_timet, 9,"%24:%mi:$se"+CHRSO 

260 sec=VAL (MIDS ($b timet,7,2)) *PI/30 

270 min=VAL (MIDS ($b_time%,4,2))*PI/30 

280 hr=VAL(LEFTS ($b time%,2))*PI/6+min 
/12 

290 : 

300 SYS "Wimp _BaseOfSprites" TO , ramsp 
ri 

310 SYS "OS SpriteOp", &13C, ramspr4, "cl 
ockface" TO RO,R1,R2,R3 

320 ORIGIN 42,42 

330 GCOL1:CIRCLE FILL 0,0,36 


340 GCOL11 

350 LINE 0,0, 34*SINsec, 34*COSsec 

360 GCOL4:LINE 0,0,22*SINhr, 22*COShr 

370 MOVE BY -2,0:DRAW -2,0 

380 GCOL?7:LINE 0,0,34*SINmin, 34*COSmin 

390 MOVE BY -2,0:DRAW -2,0 

400 SYS “OS SpriteOp",RO,R1,R2,R3 

410: 

420 !block$=-1:block$! 4=icon$ 

430 block’ !8=0:block%!12=0 

440 SYS "Wimp SetIconState",, block’ 

450 : 

460 SYS "OS ReadMonotonicTime" TO newt 
ime’ 

470 WHILE oldtime%<newt ime} 

480 oldtimet+=100 

490 ENDWHILE 

500 ENDPROC 

510 ; 

520 DEFPROCerror (!block%, $ (block%+4) ) 

530 SYS "Wimp ReportError", block’,1, "I 
con bar clock" 

540 ENDPROC 

550 : 

560 DEFPROCinitialise 

570 DIM block? 99,menu% 99,b timet 8,s 
prt 10 

580 $spré="Sclockface" 

590 quit%=FALSE 

600 SYS "Wimp Initialise", 200, &4B53415 
4,"Icon bar clock" 

610 SYS "OS ReadMonotonicTime" TO oldt 
ime$ 

620 : 

630 Bt=block?: !B%=-1:B%!4=0 

640 BS!8=-16:B$!12=128:B$!16=104 

650 BS!20=61700010B:B%!24=b times 

660 B$!28=spr3 :BY!32=20 

670 SYS "Wimp CreateIcon", ,blockt TO i 
cont 

680 ENDPROC 

690 : 

700 DEFPROCcreate_menu (X%) 

710 Mt=menu$: $Mt="Clock" :M%!12=670207 

720 M&!16=80:M%!20=44:M%5!24=0 

730 M%!28=680 :M$!32=0:M%!36=47000021 

740 $(M3+40)="Quit" 

750 SYS “Wimp CreateMenu", ,M%,X%,140 

760 ENDPROC RU 
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Special Offers to RISC User Members 


As explained in the Editorial, members will still receive a discount on our own software for the 
Archimedes. Below is a list of this software showing members prices both exclusive and inclusive of VAT. 


Members Price Members Price 

Code Product ex.VAT inc. VAT Code Product ex.VAT inc. VAT 
0109a ArcScan Il (complete) 13.00 14.95 O10ld Hearsay 45.00 51.75 
0110a ArcScan Il (upgrade) 6.91 7.95 | 0103a Hearsay RISC OS upgrade 3.83 4.40 
0107c ISOC Dev. System 68.70 79.00 

1410q RISC User Movie Maker 4.13 4.75 0100c Masterfile Archimedes 14.35 16.50 
1401a_ RISC User Toolbox (Arch.) 5.00 5.75 0111b Outline Font Pack 1 43.04 49.50 
0108d Ovation (Beebug DTP) 86.09 99.00 

0102b DFS reader 861 9.90 | 0796c Serial Link 15.00 17.25 


0104q DFSReader RISC OSupgrade 2.09 2.40 | 0105a SerlalLinkRISC OSupgrade 2.09 2.40 
0106c Hard Disc Companion 30.43 35,00 


OTHER MEMBERS OFFERS 


Wherever possible we will attempt to include details here of items upon which we have negotiated a 
special deal. These offers will only be for a limited period while stocks are available. 


Genesis 
RRP £86.95 (ex VAT) Double click o 
Offer price £45.00 (ex VAT) ae the part of tt 
£51.75 (inc VAT) Village uc 


interested in. 


An exciting information system of 
relevance to home and education. Genesis 
provides a framework for creating and 
accessing linked pages of information in a 
stimulating and interesting way. 

As reviewed in RISC User Vol.3 No.5. 
Stock Code 1900 


1st Word Plus V2 


iW pleased to be able to teil you that REE, at RRP £79.95 (ex VAT) 
cate, i 


und y 
I 
ble to sumoly HT with the goods you ordered on 
ol lows: 


details are as Offer price £49.00 (ex VAT) 
good £56.35 (ine VAT) 


M hore {nyt they neet with your full satisfaction and Pe F 
that you will order fron us again, This is the definiteve wordprocessor for 


Sees ee, the Archimedes. Written by Acorn, it is 

om fully RISC OS compatible and features a 
72,000 word spelling checker. Supplied 
with manual, discs and function keystrip. 

—— : Stock code 1945 


[() pecs resisters orem 


Ground Control’s Advanced 
Teletext System for the Archimedes 


1s 
P100H 


10 


Reviewed by Lee Calcraft 


f you want Desktop Oracle and Ceefax, 
the two main contenders for your custom 
are Morley Electronics and Ground 
Control. Morley is the better known name 
but Ground Control’s unit clocks in at less 
than half the price of the rival system. For 
an all inclusive price of £60.00 Ground 
Control supply you with their teletext 
unit, a 3.5 inch disc, and a photocopied 12 


page manual. 


Your views on the 


T 5 4 
WHAT'S ON... 
COMMUNITY . 

WHAT'S NEW .. 


Clicking on the icon bar icon opens two 
windows - a full teletext screen and a keypad 


The system is relatively easy to 
install. The stand-alone unit (which 
comes ready wired to a 13 amp plug) has 
a coaxial socket which must be connected 
to a good aerial, and a DIN socket into 
which you plug a cable supplied with the 
unit. The other end of this plugs into the 
Arc’s printer port. At 80cms this lead 
was a little short, but Ground Control 
will be supplying longer leads in future. 
Their highly unconventional approach of 
using the printer port to carry data from 
the teletext unit to the Arc means that 
you must unscrew and unplug your 
printer cable each time you want to use 


the unit. 


The way around the problem is to use 
a printer switching box (costing around 
£25) - and to facilitate this, Ground 
Control will supply an alternative lead for 
an extra £2 (if requested at the time of the 
original purchase) with a Centronics plug 
for plugging directly into a printer 
switching box. Ground Control are also 
considering providing a new lead and 
software which will permit the unit to 
plug directly into the backplane inside the 
Arc. This is likely to prove to be a popular 
alternative. A further DIN socket in the 
unit carries television video and sound 
signals. 


The software is supplied on disc, and 
this is easy to install. It is fully RISC OS 
compatible, and double-clicking on the 
!Teletext icon on the directory viewer 
installs it on the icon bar. A single click on 
this opens up two windows, a full teletext 
screen and a keypad. You will probably 
need to tune the unit before it will work. 
This is done by selecting a channel 
number from the keypad (e.g. channel 1 
for BBC 1) then clicking Menu over the 
main window, and selecting Tune. This 
brings up a window allowing you to hunt 
through the broadcast channels until you 
find the one you are looking for. When you 
have tuned in all four channels, click on 
Save to save the settings, and the job is 
done once and for all. 


Using the system is easy, you switch 
between the four channels with the 
Channel button on the keypad, and use 
the pointer with Select to enter three-digit 
page numbers. The ability to enter page 
numbers from the Desktop keypad is not 
available on the Morley system - nor is the 
excellent feature which lets you point at a 
page number anywhere within any 
Teletext frame, and click on it to select the 
new frame. 
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The software is fully multi-tasking, 
and the main teletext window can be 
resized and scrolled. This means that you 
can leave the thing running on the 
Desktop in a small corner, showing 
perhaps just the part of the screen that 
you are interested in; for example, the 
highly accurate clock. Unfortunately the 
keypad cannot be resized in this way. 


While being generally impressed by 
the software, I do have one or two small 
niggles, some of which will probably be 
cleared up in later versions. The Adjust 
button does not behave as it ought, and 
removes the menu when selections are 
made with it. Also when the task is run it 
redefines at least two of the colours of the 
Desktop palette. This is done in order to 
simulate the teletext colour palette, but it 
would be better to leave the palette intact, 
and suggest to the user that he should use 
a 256 colour mode, and then use the 
colours provided by this extended palette. 
As it is, even if you are in a 256 colour 
mode when the task is installed, it still 
redefines the Desktop palette - neither is 
any attempt made to restore it on closing 
down the application. I am also a little 
uneasy about the two modules which must 
be installed in the !System.Modules 
directory of your disc. This is normally 
reserved for shared resources such as a C 
library or the Floating Point Emulator. 


UTILITIES 

As well as the !Teletext application, 
the disc contains a number of useful items 
including a procedure library with 
routines which may be used for accessing 
individual pages of teletext. For example 
the brief program given in listing 1 is all 
that you need to download Oracle page 
311, an AA Roadwatch page, to a buffer at 
buffer% (assuming that the accompanying 
teletext module is loaded and the unit 
tuned in). You can then print this out if 
you wish, or search for data within it. For 
example, you could cycle through the 
excellent AA Roadwatch pages to find all 
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Ground Control’s Advanced Teletext System for the Archimedes 


references to jams on the M25, and 
display or print the associated text. 


10 REM >FrameSave 
20 DIM buffer 1080 


30 LIBRARY "TTXutils" 
40 PROCgetpage (3, &3110000, buffer’) 


Listing 1. Program to grab Oracle page 311 


A similar approach can be used to scan 
the business pages and store the prices of 
particular shares on a daily basis. You 
could even use this technique to update 
the Arc’s internal clock once a day (since 
all four services include the date and time 
with the header of each page transmitted), 
Regrettably, you cannot avail yourself of 
the recently defunct Ceefax Telesoftware 
service, though some Belgian enthusiasts 
are apparently using the Ground Control 
unit with high gain aerials to pick Italian 
telesoftware. 


CONCLUSION 

At less than half the cost of the rival 
system, the Ground Control Teletext unit 
represents excellent value for money. With 
the provisos mentioned, the software 
performs well, and is easy to use. The 
manual is a little brief, and could be more 
helpful at times, for example it is difficult 
to follow the hex format of teletext pages 
required for grabbing frames. Also I found 
that the example listings in the manual 
containing the procedure PROCtune 
threw up errors because its arrays had not 
been dimensioned. But this aside, if you 
can cope with sharing the Arc’s printer 
socket, then this unit is well worth 
thinking about. 


Product 
Supplier 


Advanced Teletext System 
Ground Control 

4 Alfreda Ave., 

Hullbridge, 

Hockley, 

Essex SS5 6LT. 

Tal. (0702) 230324 


£60.00 inc. VAT and post RU 
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Archimedes Software 


Disc 7 - A New Chess Program for The Archimedes. 

A Chess program that takes full advantage of RISC OS, installing itself on the 
icon bar and running on the desktop in a window at the same time as other 
applications. You can carry on working with other programs whilst the Chess 
program is thinking of its next move. 

Features: load and save games, edit board, step backwards and forwards 
through game, computer ‘v' computer mode, play black or white, reverse board, 
save game setup. multiple levels, print game. Moves displayed in algebraic 
notation. Full mouse control over game, on screen clocks, Hint. Choice of piece 
when promoting pawn. New better design of board and pieces. Undo move. 


Disc 22 - Novapaint 16 colour paint package.- 

Paint package with two tone font system, user defined brushes, airbrush, 
auto-shader, colour fills. define graduated palettes. pixel average, area squash/ 
stretch/distort/rotate. sphere wrap, cylinder wrap. Online help, manual, demos. 


Disc 23 - Desktop Applications 

Disc of RISC OS l!applications, 24 system fonts, sprites and Draw files. Includes 
!\Fastdesk, !Backpict, !FileHelp, |CopyOpts, !FontFix, !Pointer(1-3), |RomSprite, 
\Indicator, Saver, !SectCopy, !SoundOff, !Timer, !FormatTxt, !Aquarium. 


Disc 24 - RISC OS Desktop Multitasking Terminals 

Bring Archie comms to the desktop. Stay online whilst using other programs. 
Viewdata and ANSI/VT220/100/52 emulations. Suit Prestel, bulletin boards and 
mini/mainframes. Auto logon scripts. CET, ASCII and X/Ymodem (batch), file 
transfer. RISC OS printer driver support. !RS423state. CET coder. 


Disc 12 - The World 

130,00 points on the earths surface, outlining the continents, lakes, and borders. 
Disc 26 - World Map 

!WorldMap, takes the data off disc 12, and converts it into !Draw file maps. Now 
you can make your own map of any part of the world and import it into !Ovation, 
!Impression, !Draw etc, RISC OS !app. Includes C source, Also many extra 
items, desktop magnifier, make bit maps for outline fonts, cassette labels etc. 


Special Offer, you can have disc 26 for just £1.00 when you buy disc 12. 
Discs 12 and 26 together count as one disc. Offer applies if you have disc 12 already. 


Disc 1 EMACS. Classic multi document editor with macro language. Includes full C source. 
Disc 5 C Toolkit. 20+progs for C programmers with sources, grep, awk, make, sed, more... 
Disc 6 Kermit. Archimedes, BBC and MSDOS versions of file transfer/comms. prog. 

Disc 10 More C Tools, yacc and lex with examples and C source. New versions... 

Disc 14 GNU Tools#1. Quality tools with source. grep, egrep, sed, awk, diff. New versions. 
Disc 16 Spark. RISC OS file and directory archiver. !backdrop, pd. !apps. 1Mb colour pics. 
Disc 19 Starchart. RISC OS program to make Draw file starmaps. Catalog of 9000 stars. 
Disc 27 Cubic Solver - Program to give graphic solution of Rubiks cube. Colour pictures. 
Disc 28 Utopia - Graphic adventure creator program. Plus text adventure system. Examples. 


Each disc is £5.99 inc. Buy four claim another one free! 
David Pilling, P.O. Box 22, Thornton Cleveleys, Blackpool. FY5 1LR. 


Free Air Mail delivery on overseas orders. Full list available on request. 


Application Directories Revisited 


David Spencer looks at the make-up of !Boot and !Run files. 


B ack in RISC User Volume 2 Issue 4 
we took a look at the various files that 
make up a multi-tasking application, and 
discussed Obey files. In this article we 
shall concentrate on the !Boot and !Run 
files, and cover their functions step-by- 
step. In particular, we will deal with some 
of the subtle points which can prove a trap 
for the unwary. As an example, we shall 
take a look at Edit, the !Boot and !Run 
files of which are reproduced (except for 
their comments) in figures 1 and 2 
respectively. 


IconSprites <Obey$Dir>.!Sprites 
Set Alias$@RunType FFF Run <Obey$Dir> 
»! Run $3*0 


Figure 1. !Boot file tor Edit 


THE !BOOT FILE 

The !Boot file of an application is run 
automatically when the directory viewer 
containing that application is opened for 
the first time. 


The first operation this particular 
{Boot file performs is to load the sprites 
used to represent the application, and any 
files it uses, in directory viewers. This was 
dealt with in the earlier article, and will 
not be covered further here. Note that the 
pathname of the !Sprites file is specified 
using the system variable Obey$Dir. RISC 
OS automatically sets this to the 
pathname of the application directory 
when the !Boot file is run (assuming it is 
an Obey file). For example, if Edit is 
contained in the root directory of a disc 
called ‘Applics’, then when Edit’s !Boot file 
is executed, Obey$Dir will be set to: 

adfs::Applics.$.!Edit 
This technique removes the need to hard- 
wire pathnames within an application. 


The second operation that a !Boot file 
must perform is to set up the run action of 
any file types that it owns. The second 
line of the boot file sets the system 
variable Alias$@RunType_FFF to: 

Run adfs::Applics.$.!Edit.!Run %*0 
assuming that the pathname of Edit is as 
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above. This command will be executed 
whenever a file of type FFF (text) is 
double-clicked on. Before doing so, 
however, RISC OS will replace the %*0 
with the filename of the file clicked on. We 
will see later how this name is passed to 
the application itself. Because text file 
(type FFF) are very common, RISC OS 
includes a name for the file type already. 
If this was not the case, the !Boot file 
would also need the command: 
Set File$Type FFF Text 
to give the file type a name. 


Two points to note are, firstly, the use of 
Run in the alias command. Naively you 
might think that this is superfluous, as 
entering a pathname on its own will run a 
file. However, in that case the adfs: at the 
start would be taken as a temporary filing 
system for the command, and not as part of 
the pathname. The effects of this are 
subtle, but it can cause problems if the 
current filing system is changed. Secondly, 
when the system variable is set up the 
sequence %% is used. This is because when 
Obey files are executed, any parameters 
given on the command line will be 
substituted when a %*0 sequence is seen. 
By using %%, this will not happen; instead 
one % is striped off and no substitution 
takes places until the command specified in 
the alias is actually executed, which will 
not happen until a text file is double- 
clicked on, For more details of parameter 
substitution refer to the PRM, and last 
month’s Hints and Tips. 


if "<System$Path>" = "" then Error 0 Sys 
tem resources cannot be found 

WimpSlot -min 160K -max 160K 
IconSprites <Obey$Dir>.!Sprites 
RMEnsure SharedCLibrary 0 RMLoad System: 
modules.CLib 


Set Alias$@RunType_ FFF Run <Obey$Dir>.!R 
un $3*0 

Set Edit$Dir <Obey$Dir> 

WimpSlot -min 160k 

Run <Edit$Dir>.!RunImage %*0 


Figure 2. !Run file for Edit 
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THE !RUN FILE 

The !Run file of an application is 
executed whenever the application itself is 
run, This can be the result of double- 
clicking on the application itself, or 
double-clicking on a file owned by the 
application. The main purpose of the !Run 
file is to provide a springboard to run the 
application code itself, and in order to do 
this it will in general perform the 
following functions: 

1. Repeat the !Boot file commands. 

2. Set up a path to the application. 

8. Ensure any resource modules are 

loaded. 
4. Control the memory requirements 
for the application. 

5. Run the application itself 
The order will not always be the same, 
though as we shall see shortly the commands 
to control memory allocation need to be 
carefully positioned, and obviously the 
command to run the actual application must 
be the last command in the file. 


The first step is necessary in case the 
!Boot file has not been run, caused by two 
applications having the same name, or the 
application being run from outside the 
Desktop. The third and fifth commands in 
figure 2 do this. The second step is to set up 
a system variable to point to the application 
directory, in order to allow the application 
to access files within the application 
directory once it is running. The value of 
this variable is the same as Obey$Dir, 
however, the latter whenever another Obey 
file is run, for example if another 
application is started. Therefore, a private 
copy of the path name is essential. 


The first and fourth lines of the !Run 
file are responsible for loading the Shared 
C Library module which Edit needs to 
run. This module is contained within the 
!System directory, and the first line checks 
that this directory has been seen by 
checking that a system variable is set up 
to point to it (this being set in the /Boot 
file of /System). If this isn’t the case, an 
error is given. Assuming everything is all 
right, the fourth line loads the module if 
mecessary using the *RMEnsure 
command. This takes the form: 

*RMEnsure <name> <version> <command> 
The *RMEnsure command checks if the 


named module is loaded, and if its version 
number is equal to, or greater than, that 
specified in the command. If either test 
fails then the given command is executed, 
which in our case loads the module. 


The version number of a module is 
given by the *HELP Modules command 
(ignoring the decimal point). If an 
application requires a specific version of a 
module then the *RMEnsure command 
should be executed twice, once to ensure 
the module is loaded, and a second time to 
check the version, and give an error if it is 
too old. An example of this can be seen in 
the !Run file for Draw. Incidentally, 
*RMEnsure can only check modules are 
newer than a certain version. If, for any 
reason, an application cannot work with 
new versions of a module then it must 
check the version itself when it is run. 


MEMORY MANAGEMENT 

One of the most important functions of 
the !Run file is to set the amount of 
memory allocated to the application, as 
RAM is a precious commodity in a multi- 
tasking environment. 


When an application is run, it is 
allocated the amount of memory specified 
by the Next slot in the Task Manager 
(640K by default). However, while the 
!Run file is being executed, RISC OS can 
steal back some memory, for example to 
enlarge the module area as a result of a 
*RMEnsure command. It is the job of the 
!Run file to ensure that there is sufficient 
memory, and indeed to give back any that 
is not needed. This is done using the 
WimpSlot command which takes the form: 

*WimpSlot -min mK -max nK 
The two arguments specify the minimum 
amount of memory needed to run the 
application, and the maximum that it wants. 


The action taken by the WimpSlot 
command depends on the amount of 
memory currently allocated, which will be 
the amount specified in the Next slot when 
the application was run, minus any stolen 
since. If it is between the minimum and 
maximum levels, then no action is taken. 
If it is over the maximum, then the 
allocation is reduced to the specified 
maximum, and the extra given back to the 
free memory for other applications. If, on 
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the other hand, the current allocation is 
below the specified minimum, then more 
memory is taken from the free pool to 
bring it up to the minimum. [f it is not 
possible to claim enough free memory 
then an error is given. The ‘max’ part of 
the command is optional. If omitted, no 
top limit is set. 


Edit’s !Run file includes two WimpSlot 
commands. The first sets the maximum 
level and ensures that at least 160K is 
available. This is because Edit requires a 
minimum of 160K. even if the Shared C 
Library is already loaded. Therefore, if less 
than 160K is available, it is not worth 
continuing. The second WimpSlot 
command, which is encountered just before 
the application itself is run, ensures that 
there is still 160K after (possibly) loading 
the Shared C Library module. 


One failing of this mechanism is that if 
the application cannot be run due to lack 
of memory, there is no way of undoing the 
commands already executed from the 
!Run file. For example, if there has been 
168K available, and the Shared C Library 
had not been loaded, then the first 
WimpSlot command would be OK, but 
loading the module would not leave 


enough memory to run Edit. However, the 
Shared C Library will be left loaded, 
taking up valuable memory unnecessarily. 


The final operation performed by !Run 
is to run the application’s main program, 
traditionally called !RunImage. This can 
be seen in the last line of the !Run file. 
Once again, note that a Run command is 
essential for the reasons explained above 
when looking at the alias command. Note 
also, the %*0 on the end of the command 
to include the filename if the application 
is being started by double-clicking on one 
of its data files. To show how this works, 
we will assume the pathname of Edit is as 
above, and the user double-clicks on a text 
file adfs::Winnie.$.Letter. RISC OS will 
interpret the alias set up by !Boot and 
execute the command: 

Run adfs::Applics.$.!Edit.!Run adfs:: 

Winnie.$.Letter 

by substituting the file’s pathname in 
place of the %*0. This pathname then 
becomes a parameter of the !Run file and 
is substituted in the final line to give: 

Run adfs::Applics.$.!Edit.!RunImage a 

dfs: :Winnie.$.Letter 
It is then up to Edit to read the pathname 
and load the file. RY 
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ADVANCED STATISTICAL SYSTEM 


For Acorn Archimedes; BBC Models B, B+ and Master; “Industry Standard" machines 
A powertul and practical tool for Research, Industry, Business, and Teaching 


Integrated, interactive, robust, fast, accurate, modular. Designed to facilitate data critique. 

Many data entry options. Full data management and formatted display. Extensive data transforms. 
Handles missing values and data subsets. Scatterplots, regression plots, function plots. 
Univariate statistics. Paired and unpaired t tests. Chisquare tests. Nonparametric methods. 
Unrivalled REGRESSION facilities eg weighted, through the origin, standardised. Full statistical information. 
Residuals, fitted and predicted values. Much more. Correlations. ANOVA. Contour plots of regressions. 
Regression DIAGNOSTICS - ViFs, influential points etc. Automatic warnings. 

ROBUST regression - many influence functions. Powerful NONLINEAR least squares 
Time Series, eg moving averages, exponential smoothing, causal models. 

One- Two- and Three-way ANOVA subsystems. Distributions generator. Histograms. Linear Calibration. 
Cluster analysis. Many other powerful analytical and descriptive features. Full utilities. 


Price £120-£180 (machine and version dependent). Special RISC USER discount available. 


There's far too much to describe here. Get full information now from: 
Serious Statistical Software, Lynwood, Benty Heath Lane, Willaston, South Wirral L64 1SD Tel. 051 327 4268 


Beebug Outline Fonts 
Pack 1 


Beebug Outline Font Pack 1 provides a range of high quality outline fonts designed specifically for 
the Archimedes. Each font contains nearly 200 characters designed to produce the best quality 
output on the screen and printer. 


A new 'prolog' file is supplied allowing the new typefaces to be printed on PostScript compatible 
printers. They are mapped as follows: 


Paladin is aa Palatino ® equivalent SymboIB is a Symbol equivalent 
SwissB is a Helvetica ® equivalent Vogue is an AvantGarde ® equivalent 


Beebug Outline Fonts are ideal for use with Desktop Publishing packages and Word Processors 
which use the Acorn Ouuine Font Manager. 
Please note that the Outline Font Manager is supplied with the pack. 


Font samples* from Font Pack 1: 


Paladin.Roman The quick brown fox jumps over the lazy dog 1234567890 
THE QUICK BROWN FOX JUMPS OVER THE LAZY DOG 
Paladin.Roman.ltalic The quick brown fox jumps over the lazy dog 1234567890 
THE QUICK BROWN FOX JUMPS OVER THE LAZY DOG 
Paladin.Bold The quick brown fox jumps over the lazy dog 1234567890 
THE QUICK BROWN FOX JUMPS OVER THE LAZY DOG 
Paladin.Bold Italic The quick brown fox jumps over the lazy dog 1234567890 
THE QUICK BROWN FOX JUMPS OVER THE LAZY DOG 
SwissB The quick brown fox jumps over the lazy dog 1234567890 
THE QUICK BROWN FOX JUMPS OVER THE LAZY DOG 
SwissB.Oblique The quick brown fox jumps over the lazy dog 1234567890 
THE QUICK BROWN FOX JUMPS OVER THE LAZY DOG 
SwissB.Bold The quick brown fox jumps over the lazy dog 1234567890 
THE QUICK BROWN FOX JUMPS OVER THE LAZY DOG 
SwissB.Bold.Oblique The quick brown fox jumps over the lazy dog 1234567890 
THE QUICK BROWN FOX JUMPS OVER THE LAZY DOG 
Vogue.Book The quick brown fox Jumps over the lazy dog 1234567890 
THE QUICK BROWN FOX JUMPS OVER THE LAZY DOG 
Vogue.Book.Oblique The quick brown fox jumps over the lazy dog 1234567890 
THE QUICK BROWN FOX JUMPS OVER THE LAZY DOG 
Vogue.Demi The quick brown fox jumps over the lazy dog 1234567890 
THE QUICK BROWN FOX JUMPS OVER THE LAZY DOG 
Vogue.Demi.Oblique The quick brown fox jumps over the lazy dog 123456789 
THE QUICK BROWN FOX JUMPS OVER THE LAZY DOG 
SymbolB !#3%&()*+,—./0123456789;;<=>?=A BXAE@THIGKAMNOT] _ 
OPLTYSQEWVZ|.-.J4_ GPXSeQynrpKAvoROPoTLBaEWC{|} _ 
Y’S4ob 69 40T | xdeseeI RIK MP BOWN Waccce eV 
®O™]]\-vvere=fO(@O™D} 


* These fonts are true reproductions of Beebug Outline Fonts 


Stock Code 0111B Price £54.50 


Further Font Packs (under development): 
Font Pack 2 - contains Bookman, Courier, Garamond and Chancery equivalents 
Font Pack 3 - contains New Century Schoolbook, Optima, Times and Dingbats equivalents 


Beebug Ltd, 117 Hatfield Road, St. Albans, Herts AL1 4JS, Tel. (0727) 40303 Fax. (0727) 60263 
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1st Word Plus 


We begin a new column devoted to word processing and DTP with 
some hints on using 1st Word Plus by Mark Sealey. 


T here cannot be many Archimedes/ FILE TRANSFERS 


A3000 users who do not at some time use Suppose you have files from the good old 
their computer for word processing. Many of —_ gays of View and Wordwise Plus, and that 
these will use Acorn’s own Ist Word Plus you can get them onto a 3.5” ADFS format 
(1stW+), which was originally released disc, perhaps by using BEEBUG’s serial link 
shortly after the Archimedes 300 series. or 5.25” drive interface (see the current 
Retail Catalogue). You now want to transfer 
Less than a y Gar abo, however, a fully those files to 1stW+, and they are sitting in 
RISC os compatible Release 2 came out. 4g directory (though probably without icons - 
This was reviewed in RISC User Volume 3 just white rectangles) in a window on your 
Issue 4 and was found to be a vast desktop. This is where a very useful little 
improvement - ‘even if it did not contain all public domain utility called IstFile comes in 
the features a professional’ word processor (supplied on this month’s magazine disc). 
might, The review alluded to several pjoyble-click on this application to install it 
utilities and add-ons which can help to _ on the icon bar. 
squeeze more from what is still a powerful 
package. The purpose of this article is to Simply by dragging the View or 
look at several of these in greater detail. Wordwise+ file onto the 1stFile icon, you can 
The intention is not to assess these features, —_ gave it back to disc in the new format. Doing 
but to concentrate on helping you to this to the first file creates and opens a 
enhance the use you make of IstW+. directory viewer. Now click with Menu on 
the name of the file you wish to transfer, 
choose the required conversion (View to 
1stW+ etc.), then close the 1stFile window. 
Your new file will now have overwritten the 
old format one. The version I tested 
sie 2 5 ah Fey ih te be able te tell seq Chat SERIMEs pee supported conversions from 1stW+ to both 
Text (that is filetype &FFF) and View, and 
vice versa, as well as Wordwise+ to 1stW+. 


that iy full t 
hat you By ft Ray j= Ba peer ele santas one 


There are snags, though. It appears that 
you must have both IstFile and any files to 
be converted on a disc in drive 0, and you 
must set the files to the appropriate filetype 
yourself. If the disc is write-protected, the 
machine locks up. The software was tried on 
: several View files and did not always deal 

Example of a document with commands and properly with LFs or CRs, making it 
Keywords for tst Mail and light print necessary to go through the resulting 1stW+ 
file and remove these manually. 


Yours sincerely, 


In this issue, we will consider such 
facilities as transferring files from other 1stW+ still has one or two irregularities 
(perhaps 8-bit) word processors, and _ in this respect, which make final formatting 
personalising and customising your of a paragraph slightly unpredictable. These 
correspondence. In a future issue we will are not insurmountable difficulties but 


look at dictionaries, bug fixes and printer worth knowing about if you ever forget to 
drivers etc. work from backups of what - almost by its 
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very nature - would be valuable data. Now 
there have been other routines published 
but this seems (despite its shortcomings) 
one of the best and easiest to use. It would 
not need too much imagination, either, to 
save Pipedream 3 files in text format and 
then convert them into 1stW+. 


So, you have now transferred all your 
files to 1stW+ format and decided to 
standardise on this as your main word 
processor; what else can you do to get the 
best performance from it? 


MAIL MERGE 


One of the more powerful features of the 
1stW+ package is the ability to annoy 
friends (soon to become enemies) with 
multiple yet personalised correspondence. 
Again, suppose that you have a plain ASCII 
list of recipients, perhaps with their 
addresses in the same file. This may have 
been exported from Masterfile, System 
Delta Plus or Multistore. Such a list might 
have been created using Acorn’s Edit,or 
even 1lstW+ itself (though in non-WP mode, 
which you can effect from Edit on the main 
menu). 


As an example, consider a company 
which wishes to acknowledge orders to 
customers, advising them that the goods 
they ordered on a particular date are now 
ready to be dispatched. Although the 
substance of the letter will be the same for 
all the customers, the details to each of 
them will differ. Hence the need to record 
these details in a separate file. 


Two chapters (40 pages) in the Release 2 
manual explain the use of 1stMail, which is 
supplied with 1st Word Plus as a separate 
RISC OS application. 


Clicking Menu over the icon bar icon and 
selecting Printer allows you to install the 
same printer driver for 1stMail which you 
use with lstW+ itself. Installation is 
achieved by dropping the driver icon (to be 
found in the !lstWord+ directory) onto the 
appropriate line in the dialogue box 
displayed. If only the default driver is 
installed, this line will read: “Standard 


backspacing printer”. This is unlikely to be 
capable of the styles and fonts you want and 
may not be compatible with your printer at 
all, so is really best changed. (To install a 
driver permanently as your default, just 
place it in the !I1stMail directory with the 
filename !1stMail.1WP_print, giving it 
filetype &DOB.) 


The other useful thing you can do with 
the Printer option in 1stMail is to direct the 
merged output to any one of four devices: 
Parallel, Serial, Network or File. The latter 
is a useful option; a standard 1stW+ file 
(albeit potentially quite lengthy) containing 
the eventual merged document will be 
saved. This is to be recommended if you are 
not used to mailmerging or are 
experimenting with certain lstMail 
keywords such as Repeat, for example, 
which might have unpredictable results 
unless you-are sure. 


It is wiser to have this output on disc 
where mistakes can be edited or deleted, 
rather than having to abort a paper-wasting 
print. Remember, though, that you will have 
to specify a filename for this output - not at 
this point but once the merge has started - 
and in standard RISC OS fashion. 


Assuming that everything is now set up 
and you have closed the dialogue box by 
clicking on OK, you can now perform a 
merge. To do this it is necessary to drag a 
file from which the merge will be made 
directly onto the 1stMail icon on the 
Desktop icon bar. There will be no point to 
this unless that file itself contains 
commands instructing the application to 
process the data - names and addresses for 
example - from the previously prepared data 
file (for which you will also be prompted), 
and to arrange the resultant output exactly 
as you want. This is achieved by the use of 
keywords and commands. These are typed 
into the document which will form the basis 
of the merge. For this, use 1stW+ as if you 
were editing any other document. For 
1stMail to recognize them, however, they 
must be highlighted in the usual way (click 
with Select and drag an inverse video box 
over them), then marked with Function Key 
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F4 as “light”. On highlighting another 
section of text or another keyword (or 
formatting with F7) they will then appear 
on the screen in a lighter grey than normal 
text and will not be printed if the file as it 
stands is sent to the printer. See figure 1 for 
example. 


oop “hustoner's it a bare 
vt *Custoner’s iadress t, address 


* print nane and address at head of letter 
Vane 


ar none, 
I an pleased to be able to tel! gow ety 


] eerie ee 


Example of the use of the Input Command 


COMMANDS AND KEYWORDS 


I have mentioned commands and 
keywords. Commands, which must be 
placed at the very start of a line, can also 
only appear one per line; they instruct 
lstMail to alter the format or display, to 
collect data from a particular file, and how 
to treat individual data items. There are too 
many commands to deal with here but their 
use might well form the subject of a later 
article, and is in any case covered on pages 
125 to 130 of the 1stW+ manual. Try 
experimenting with them after you have 
understood the basic idea. 


Keywords, on the other hand, do not 
have the same restrictions as commands. 
They are really what are sometimes known 
as ‘macros’, each one of which stands for one 
item of data, which will be extracted from 
the data file when the merge is run, Note 
that they do not have to be read in the same 
order in which they are eventually used. In 
the example shown in figure 1, the first line 
reads in the four items of data from a data 
file (which you will have to specify) and uses 
them when it comes across them in the body 


So far so good, but how can you instruct 
1stMail to carry on generating individual 
letters until the data is exhausted? Simply 
by placing the keyword Repeat in your 
source document (the one to be merged) 
after a page break and on a line of its own. 


Even this is not the end of 1stMail’s 
capabilities. You can enter the data in real 
time, so to speak, and arrange for 1 stMail to 
prompt you for individual items. You still 
have to prepare the source document 
properly; but by inserting the (light) 
command /Jnput in your source document 
and the data items as in figure 2 (note the 
comments preceded by light punctuation 
marks), you can save yourself time and 
trouble by merging in this fashion if there 
are too few copies to justify setting up or 
running a fully blown datafile. You just 
respond to the prompts when they appear. A 
more advanced technique still is the 
inclusion of one document for processing 
from within another. These files can even be 
nested and any commands and keywords 
placed in them behave consistently with the 
rules just discussed. The 1stMail command 
to use in this case is includefile. 


Suppose you have a file with your 
letterhead at the top, and “Yours faithfully” at 
the end. 1stMail can operate on this with the 
command includefile <filename>, where 
filename must include the full RISC OS 
pathname. 1stMail will suspend work on your 
letterhead file and pass to the text contained 
in the file specified in filename. This is a 
useful way of saving time and of avoiding the 
creation of lots of files when you often send 
correspondence, say, of a similar nature, Think 
of it also as a way of including in any ‘parent’ 
letter various ‘child’ paragraphs from a wider 
selection, each of which can be separately 
composed and updated. Again pages 107 to 
111 of the Acorn manual explain the order in 
which files will be processed. 


I have concentrated here on two areas 
which may be of interest to 1stW+ users, 
but there is a great deal of scope for further 
articles. 


Next month we will give some hints on 


of the text. using Impression. RU 
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London (ITC Garamond®) 
Oxford (Optima®’) 
AyiAfios, * 2 Q(Rop) ** 
Xmas, Hot Dog 
oe HE KKKEOP mI 


< Tamsin (Crush Serpt®*) 
Sophie (Park Avrnuc®’) 


(i) These are just a few typefaces selected from over 100 fully 
hinted fonts available now. They can be used with any Archimedes 


DTP program and may be mixed freely with other fonts. 

*Many of our fonts are now 100% PostScript® compatible. 
Of course, EFF originals do not have PostScript equivalents. 

2] The prices vary depending on number of fonts and type. 
Site licences for schools and business use available. 

3] We also sell Canon BJ-130e Ink Jet printer with a resolution 
of 360 dots per inch. This printer can use A2 paper and is ideal for 
professional work. Price, including the Printer Driver, is 
£795.00, but we give up to 30% discount. 

Other DTP software & hardware available, see our Price List. 
This advertisement was made using only ACORN DTP, our fonts & Canon BJ-130 printer. 

tMathGreek, *Full (224 symbols) Dingbats fonts. 
Prices are exclusive of VAT and delivery 
Please write for a free 24 page Font Catalogue & Price List to 
The Electronic Font Foundry + 18 Brockenhurst Road - ASCOT SL5 9DL 


or t 0990-872923 (24 hours) 
We accept Visa, MasterCard, EUROCARD & Access 


International Character Sets 


Alan Wrigley looks at the function of the International module on the 


Archimedes. 


he International module, which forms 
part of the RISC OS operating system, is 
provided to enable a number of different 
international alphabets to be to be 
mapped to the ASCII character codes, and 
to be accessed from the keyboard. These 
two functions can be performed 
independently or in conjunction, giving a 
great deal of flexibility to the way the Arc 
handles international characters. 


a ee 


OOO MMO Mee 


oresce ms mm 
acme ee Fee Semin 


2 
§ 
aR 
b 
r 
% 
¢ 
z 
a 
6 
3 
a 


A number of alphabets are built into 
the computer, each of which defines the 
ASCII codes 128-255 to its own standard. 
To see a list of the alphabets currently 
available, type *Alphabets at the 
command line. *Alphabet on its own 
shows the currently selected alphabet (you 
can abbreviate it to *Al.), while *Al. 
<alphabet name> sets the named 
alphabet. To see the difference between 
them, enter Basic, set each alphabet in 
turn, and type the following line to see the 
characters: 

FOR 1%=128 TO 255:VDU I%:NEXT 


On the other hand, the command 
*Keyboard <country name> (see below for 
how to get a list of these), sets the actual 
codes which are produced when certain 
keys on the keyboard are pressed. This 
does not, on the whole, enable all the 
specified country’s extra characters to be 
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allocated a key on the keyboard (for 
example accented characters in French or 
umlauted characters in German are not 
given a key), but merely arranges the 
keyboard layout to suit the country 
concerned. For example, on a German 
keyboard the positions of Y and Z are 
transposed, presumably reflecting the 
different emphasis on these letters in that 
language, However, the extra characters 
(umlauts, accents etc.) can still be 
accessed by typing the character code on 
the numeric keyboard while holding down 
the Alt key. 


Both the alphabet and the keyboard 
layout for any country can be set together 
by using the command *Country <country 
name>, The setting can also be configured 
as a start-up default by using *Configure 
Country <country name>. A list of the 
available options can be seen by typing 
*Countries. 


PRINTING INTERNATIONAL 
CHARACTERS 

So far, so good. But what if you want to 
output international characters to a 
printer? If you are using a RISC OS 
printer driver to print from a Draw file or 
DTP document, say, then there is no 
problem, since the characters will be sent 
to the printer in bit-image mode exactly as 
they appear on the screen. But if such 
characters appear in a text file, then you 
are in trouble. This is because, while the 
Archimedes generally uses ASCII codes 
128-255 for international characters, most 
printers substitute some of the non- 
alphanumeric characters between 32 and 
126 with the extra characters required by 
the currently selected language. So for 
example, while code 126 in English 
normally produces a tilde (~), when the 
German set is selected on an Epson 
printer you will get a double “s” (p). 
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Fortunately the solution to this is at 
hand in the shape of our TextPrint utility 
published last month. To modify the 
program for your own use you will first 
need to find out the codes for the required 
characters on the Archimedes, and the 
codes needed by the printer to print them. 
The former can be done by typing: 

FOR I%=128 TO 255:VDUI%:PRINT I3:NEXT 
and noting down those you need. For the 
latter, you will need to study your printer 
manual, where you will (usually) find a 
comparison table between the characters 
in each of the available sets. 


Having done this, you must then alter 
TextPrint’s /RunImage program by adding 
as many lines as required after line 760. 
Each line must send the printer the codes 
to set the appropriate country (unless you 


| 
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Art MACHINE? 


EXHIBITION SOFTWARE PACKS NOW AVAILABLE! 


The Archimedes/A3000 generates stunning graphics. That's why 
exhibition organisers Triangle Projects chose it for "Glasgow's biggest 
ever art event for kids" - THE ART MACHINE, McLellan Galleries, 
June 2nd to August 26th 1990 (opens at the Barbican in April 1991). 


Enjoy making your own animated films with MOVING SQUARE 
(watch it spin, shrink and glide around the screen) and CYCLIC 
STORY (‘characters' include squirrels, birds and a dying world). SNOWFLAKES lets you produce 
stunning fractal snowflakes - and you don't have to be a Professor of Maths! PATTERNED TILES 
generates colourful mosaics from digitised drum sounds (or boring maths functions), while FRACTAL 
TREES lets you design your very own trees - with or without fruit and leaves! 


Five exhibition quality discs - something for any age and all the family - for only £25.00 
plus VAT + £1.00 post and packing. 


NEW! A3000 infant software: TINY LOGO, TINY DRAW and FREDDY TEDDY's ADVENTURE 
ask for details! 


Telephone (24 hours) 0733 244682 VISA 
* maser 


already have your printer configured as 
such), followed by the character code, and 
finally the codes to return to the default 
country setting. So if you want to print the 
German letter B, you need the following 
line: 

761 WHEN 226:BPUT#P%, ES+"R"+CHRS2+ 

"~"+ES+"R" +CHRSO; : free$-=7 
If your printer is already set to Germany, 
all you need then is: 

761 WHEN 226:BPUT#P%, "~";:freet-=1 


This month's magazine disc contains a 
program which displays any of the 
resident alphabets on the screen. The 
RISC User Volume 3 Special Dise will 
contain an updated version of TextPrint 
which will enable you to print out the 
extra characters from a number of 
international sets. RY 


1] 
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BPUT#...GET$# 


Alan Wrigley explains Basic V's enhanced commands for putting and 


retrieving bytes to and from a file. 


n the BBC micro, BPUT# could only 
output a single byte to a file, e.g. 
BPUT#file%,64. This could then be read 
back from the file by using BGET#. 
However, in Basic V, the scope of BPUT# 
has been expanded. As well as a single 
numeric byte as before, it will now take a 
string as an argument (with a maximum 
length of 255 characters), The characters 
of the string are then sent to the file one 
by one, followed by a linefeed (ASCII 
value 10) unless the string is terminated 
by a semi-colon. The following examples 
illustrate this use of the statement: 

BPUT#filet, "Hello" 

BPUT#file%,AS+CHRS$ (44) +B$; 
where file% is the file handle allocated by 
OPENUP or OPENOUT ete. 


BGET# can still only read back a 
single byte however, but a new function 
GET$# is provided which reads in a string 
which has been output using BPUT#. 
GETS$# reads characters from the file until 
an ASCII code 0, 10 or 13 is found, but 
this is not added to the string. The end of 
the file, or the maximum of 255 
characters, will also act as a terminator. 
The resulting line of characters is then 
returned as a string, as in this example: 

string$=GETS#file% 


It may appear unnecessary to suppress 
the linefeed character by using a semi- 
colon; after all, if you are sending a string 
to a file, will you not want a terminator 
byte to indicate the end of the string 
anyway? This is largely true if you are, 
indeed, simply writing strings to a file, 
but consider the situation where you have 
opened the printer stream as an output 
file, using a statement such as: 

file%=OPENOUT"printer:" 

If you then send a list of control codes to 
the printer as a string, you do not want a 
linefeed after each command to set italic 
or bold etc. 


RISC User October 1990 


Another situation where you would 
want to suppress linefeed characters is 
when you are building a pure ASCII text 
file using BPUT#, with carriage returns at 
the end of each paragraph. A paragraph 
may well be more than 255 characters 
long, in which case you would need to use 
successive BPUT# statements with semi- 
colon terminators, adding a CHR$(13) at 
the end of the paragraph. 


If you are already acquainted with the 
filing system commands in earlier Basics, 
you may well be wondering why on earth 
you need these enhancements when two 
perfectly good commands for reading and 
writing strings already exist, namely 
PRINT# and INPUT#. The answer lies in 
the intricacies of Basic. When you send a 
string to a file using PRINT#, it does not 
simply put the characters one by one into 
the file. Instead, a descriptor byte is first 
filed, in this case value 0 to indicate a 
string. Then the length of the string is 
stored in the following byte, followed by 
the characters of the string itself in 
reverse order. Thus the following 
statement: 

PRINT#files’, "ABC" 
will send to the file 0,3,67,66,65 where 
67,66,65 are the ASCII codes for C,B,A 
respectively. This would then be read back 
with: 

INPUT#file}, string$ 
which would reconstruct the original 
string “ABC” in string$. 


On the other hand: 

BPUT#filet, "ABC" 
would send the bytes 65,66,67,10 to the 
file. The advantages of this method are 
that, firstly it enables you easily to send 
control code strings to a printer as 
described above, and secondly, you can 
prepare text files from within Basic which 
can be read by a text editor such as Edit. 


(AY) 
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Here at last... 


A beautifully engineered, attractive, 
fast, A3O00 hard disk drive 
for only £399 + VAT 


A3000 ST506 Podule & 
Hard Disk Drive 


The Morley ST506 interface for 
the A3000 has been designed to 
introduce the A3000 user to the 
world of hard disk computing at an 
affordable price but without sacri- 
ficing speed or quality. 


MQ 


The ST506 podule is a 16 bit card 
providing high data transfer rates 
to and from the A3000. The card 
and accompanying module are de- 
signed to be fully compatible with 
the ADFS filling system therefore 
making it compatible with all exist- 
ing software on the market. When 
installed the software appears as 
an icon onthe desk top in the same 


Leuba psi besislcina:t Bete %*& Super fast - 16 bit interface and 28ms disk 
icon and is accessed in the same iH F B 

way. drive make this a really speedy unit. 

The card itself will support drives % Aesthetically pleasing - 3.5" mechanism 
with a maximum of 8 heads and used to reduce size, cases colour matched. 
1024 cylinders. This gives a pres- 

ent total maximum capacity on * Beautifully engineered - High quality com- 
any:one drive of GEMS. ponents used including whisper quiet fan 
The podule comes ina colour coor- and switched mode power supply. 

dinated steel case which fixes to 

the rear of the A3000. The hard 

disk mechanism is enclosed in a 

separate steel case (also colour Another quality peripheral 
coordinated) with switch mode designed & manufactured by... 


power supply and whisper quiet 
fan to ensure that the unit remains 


cool. This unit is connected to the 
ST506 podule via centronics type 
shielded cable to prevent any RF 


interference from the hard disk and 


podule, E.L.E.C.T.R.O.N.I.C.S. L.T.D 


20MB and 40MB hard disks are 


supplied as standard but other sizes 
are available on request. ...who else? 


Available from all good dealers or direct from Morley Electronics (please see our other advertisement in this issue} 


The British Isles In Relief 


by G.Blackwell and Lee Caicraft 


a i his program displays a coloured map 
of the British Isles against a blue 
background, All land areas of the map are 
raised to give a three dimensional effect, 
as you may be able to discern from the 
screen shot, 


The map has many uses, from 
providing the basis for a geographical quiz 
to supplying geographical information in a 
visual form. It is also possible to change 
the scale and position of the map (see 
below). 


To get the program going, simply type 
it in and run it. Apologies for the 
extensive data statements - these are 
essential for drawing the map at the 
present level of detail. You will need to 
take care typing in these values or the 
shape of your map will be distorted. 


Screen “display D produced by listing 1 


HOW IT WORKS 

The outline of the British Isles is 
drawn by repeated calls to PROCisland 
(one call for each island mass). This uses 
PROCpoint to read off pairs of 
hexadecimal values of X and Y co- 
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ordinates, and these are used to construct 
an outline. Once all the outlines have been 
drawn, PROCplotit fills them in using 
data from line 1060 onwards to supply the 
starting point - again in co-ordinate pairs - 
for each fill. 


To achieve the raised effect, this whole 
process is repeated five times in lines 200- 
240 with a slightly different starting point 
and with a different colour fill number. 
The first four colours are defined to be 
identical (lines 110-140), and form the 
colour of the vertical edge of the land 
masses. The fifth filling sequence uses 
colour 7, the colour of the horizontal 
surface of the map. 


If you want to alter the scale of the 
map, you can change the values of W% 
(width) and H% (height) in line 180. The 
position of the map on the screen can also 
be altered by adjusting the values of PX% 
and PY% (at line 190), the horizontal and 
vertical co-ordinates of an arbitrary point 
at the bottom left-hand corner of the map. 


10 REM >GBMap3 

20 REM Program British Isles Relief 
30 REM Version A 0.03 

40 REM Authors G,. Blackwell 

50 REM Lee Calcraft 


60 REM RISC User October 1990 
70 REM Program Subject to Copyright 


80 : 

90 MODE 12 

100 COLOUR 1,0,112,196 :REM background 
110 COLOUR 3,96,48,0 :REM land edge 
120 COLOUR 4,96,48,0 :REM land edge 
130 COLOUR 5,96, 48,0 :REM land edge 
140 COLOUR 6,96,48,0 :REM land edge 


150 COLOUR 7,176,128,64:REM 1nd s’ face 
160 GCOL 129:CLG 
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The British Isies in Relief 
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170 GCOL 4 
180 Wi=3:Ht=3 :REM scale 
190 PX$=240:PY$=100 :REM position 


200 FOR N=l TO 5 
210 GCOL N+2 

220 PROCplotit 

230 PX$-=2:PY%+=2 

240 NEXT 

250 END 

260 : 

270 DEFPROCplotit 

280 ORIGIN PX$, PY$ 

290 RESTORE 

300 REPEAT 

310 PROCisland 

320 UNTIL Y%=0 

330 FOR At=1 TO 9 

340 READ X%, Y% 

350 PLOT &8D,W%*X%/3,H3*Y3/3 

360 NEXT 

370 ORIGIN 0,0 

380 ENDPROC 

390 : 

400 DEFPROCisland 

410 READ AS 

420 PROCpoint 

430 MOVE X%*W%, Y$*HS 

440 REPEAT 

450 IF AS$="" THEN READ AS 

460 PROCpoint 

470 IF X%*Y%>0 THEN DRAW X3*W%, Y$*H$ 

480 UNTIL x%*Y%=0 

490 ENDPROC 

500 : 

510 DEFPROCpoint 

520 BS="&"+LEFTS (AS, 4) 

530 AS=RIGHTS (A$, LENAS-4) :¥$=EVAL BS 

540 Xt=¥$ DIV 256:Y%=Y% MOD 256 

550 ENDPROC 

560 : 

570 DATA SCF69AF29CEE8CDE91DES8EDA9 6DC 
580 DATA SADCA4DAAADBAEDABOD6AED2A6BC 
590 DATA A2BAQEBAA4B4 98AD92AE96AAAQAD 
600 DATA AAAAB3A1BC89BA86CO86CE7ACC76 
610 DATA D26CC86CD268D660D65DD058D656 
620 DATA DCSAE65AEC56EE50EC42E83EE83A 
630 DATA £23AE238E335E132DA30E230E42E 


640 
650 
660 
670 
680 
690 
700 
710 
720 
730 
740 
750 
760 
770 
780 
790 
800 
810 
820 
830 
840 
850 
860 
870 
880 
890 
900 
910 
920 
930 
940 
950 
960 
970 
980 
990 
1000 
1010 
1020 
1030 
1040 


1050 : 


1060 
1070 
1080 
1090 
1100 


DATA EC30EC28E626E421D81BD41CC81C 
DATA C41AC41EC01ECO1CBC1EBC1CB419 
DATA B01AB417B214A616A21A9A169816 
DATA 9812940B900B8A0E800E800B7A08 
DATA 7005760573086E0S6E0A780E7E16 
DATA 8218841D84218A218A2696289C26 
DATA A4309E309A2B922D92328E328A30 
DATA 86367E327A3276367A38763A8C46 
DATA 8£508C56845183527F52885A885C 
DATA 906094609861A05E9C659C6AA46E 
DATA 9D6E9E73A072A27A9E7A9C769A76 
DATA 9A7B94829A8F968F 948C8ES8A888C 
DATA 8886808C80857E857A907D8E849E 
DATA 80A480AC7CA478AA78A4 74987098 
DATA 74AA76BA70B46AB46CB8 6ABC6EBE 
DATA 6CC172C274CB70C964D4 66DA6AD6 
DATA 6ADC72D072D674E07CE079E57CE6 
DATA 7AEATEEATCEE7EF484F287F4B89F2 
DATA 8CF496F497F69CF60001 

DATA 7OFO6CEA6AE262DC60E062E360EA 
DATA 64EA66EE68EE6CF270F00001 
DATA 5FDB5SFD65DD65CCA56C458D456DC 
DATA 5FDB0001 

DATA 70B06FBO6BAA66A66AA06EA26EA5 
DATA 71B00001 

DATA 7AA07DA27E9C7B9C7AA00001 
DATA 827482798880897A82740001 
DATA 865E8C6286658462865D0001 
DATA BE1AC218BC16BA18BE1A0001 
DATA 6A97728B6E867586768074807182 
DATA 727E747C707A6D7666736A696962 
DATA 6B5A684C6446664252414638443A 
DATA 40353331303328322E3726362A3C 
DATA 263B213C22402A44204524492A47 
DATA 2A4C325028503256325A345E3A5E 
DATA 3A6537622E642C672668286C2C6C 
DATA 2D71317132742C7428772D77297B 
DATA 2A7F2E7E2E81387F3A7C3C7E437C 
DATA 428048824A8746874089448B448E 
DATA 488E4C8C539856945699599C5E9A 
DATA 5C995A945C915F9360986A970100 


DATA 230,300, 560,200 
DATA 308, 693,270,626 
DATA 325,501,374, 476 
DATA 400,367, 403,293 
DATA 569,74 Rw 
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Reduced Prices on 


BEEBUG SCAVENGER 


The Beebug Scavenger image scanner adds life to Desktop Publishing, Word Processing, Drawing and Painting, and many 
other activities. Just some of the possible uses are: ————————— ee 


se Hewlett-Packard DeskJet Plus Immediately on top of 
printer uses ink jet technology to obtain the collecting tray for ; 
an output quality approaching thatofthe This Jatter usce # mect 
laser printer. Yet it costs only a fraction of each emerging sheet unti 
the price, weighs & mere 14 Ib (the and then drops it onto 
Panasonic KX-P4450 laser printer weighs (face up in reverse order 
56 ib), and requires a minimum of The reason for the « 
maintenance presumably to prevent i: 
being smu 
arrival of t 
have to 

experienced 
during tests 
graphics 

noticeably da 
some sign 
wrinkling aft 


+ Incorporating photographs and drawings into text documents. 
+ Scanning pictures to use them as templates for line drawings. 
+ Creating artwork for exciting title screens. 

+ Scanning photos and text to make a graphical database. 


Scavenger consists of a professional quality scanner, a 
half-width interface card, and a comprehensive user 
guide covering installation, use, hints and tips, 
technical information and routine maintenance. 


Scavenger is available with two different scanners. 
For most users the 
half-width scanner, 
capable of reading an 
image up to 105mm 
wide, will be suitable. 


The Desk 
bath serial 
interfaces, a 

< 


If you find your The Wimp-based software to 
requirements grow, operate the Beebug Scavenger 
you can upgrade to the is incorporated in a ROM on 
full A4 width device, the interface podule. 


Scavenger A4, which 
can scan a 216mm 
wide image. 


Scavenger is operated from the 
Desktop, and you can choose 
whether you want the software 
to install itself automatically on 
the icon bar, or whether you 
wish to start it manually through a star command. 
Just some of the features offered by the software are: 
* Variable image size, with the maximum width being 
limited by the scanner, and the depth limited only by the 
available memory. 
* Real-time display into a window as the image is scanned, 


* Save the scanned image as a sprite or as a bit-image Draw 
file. 


Price Stock Code 
Scavenger £149.00 0730g 
Scavenger 3000 £175.00  0735g 
Scavenger A4 £342.60 0731g 
Scavenger 3000 A4 £408.65 0733g 
Sheetfeeder for A4 models £146.96 0732g 
All prices exclude VAT. Carriage on these items is £8 
The Archimedes models of Scavenger are available now, 
the A3000 models will be available shortly. 


To obtain the greatest scanning precision, a sheet * Conversion of dithered monochrome image to sixteen 
feeder can be added to Scavenger A4. This is fully grey levels. Ideal for enhancing photographs. 
automatic and can scan an entire A4 page under * Full control of optional sheet feeder to allow automatic 
software control in just 15 seconds. scanning. 


Technical Specification 
Maximum image width: 105mm for Handheld models; 216mm for A4 models. 
Maximum image depth: _ Limited only by available memory 


Resolution: 100, 200, 300 and 400 dots per inch for handheld model; 200 dots per inch for A4 model 
Scanning mode: Reflective with CCD sensor 
Dropout Colour: Yellow-Green (570nm) 
Operational modes: Black and white or 16 grey levels for A4 model; 

Black and white or choice of three patterns of 32 grey levels (focusing, dot and mean) for the Handheld model 
Interface: Half-width expansion card, fitted internally to Archimedes, or in external case (supplied) to A3000 
Power Source: Internal for Archimedes; from external unit (supplied) for A3000 


Computer requirements: Either an A3000 or an Archimedes with RISC OS, a podule backplane and at least 1 Mbyte of RAM 
Software: ROM-based Desktop application 


PIPEDREAM 3 


Pipedrean: adfs::a44Buini.$.pd.ExanplesP).AdSS 


| Peery ViacecerMasversnabccccsrsceDersecesCresccsFersssOnevcrccem S 
Car Lovers Annual Report on Company Fleet 
Value Value b 

year ago now ime Crews Cyls Reg. 
Porsche Carrera RSL £50,000 £150,000 MO0% 2,700 6 RS 27 
AC Cobra 289 Mb II £90,000 £150,000 166.7% = 4,700 & 289 COB 
Jaguar D type £375,000 £950000 253.3% AACO 6 DI 
Ferrari 250 SWB £500,000 £1,100,000 220.0% 3,300 12 SWB 280 
Ferrari 108 GTB £35,000 £60,000 1714% 3,000 8 GTB 308 


Fleet values 


superb classic cars has 

perfarmal outsiand- 

ingly, cutstripping 

mst conventional 
8 forms of investmem, 


The outlook remains 

fosy, with = more 

invesiment funds oo 2 > 

flowing onto = the Wrevche RS AC Cotes lagu bert SWE teria) Se 


PipeDream 3 breaks down the barriers between word processor, spreadsheet and database. You can 
include numerical tables in your letters and reports, add paragraphs to your spreadsheets, and perform 
calculations within your databases. 
Based on PipeDream 2, the best-selling integrated package for the Archimedes, PipeDream 3 has been 
completely re-written to take full advantage of RISC OS - if you can use RISC OS, you can use PipeDream 
3. Itis fully multi-tasking and multi-windowing, so youcan workon many documentsatonceand instantly 
move information between them. And since PipeDream 3 can automatically load and save most popular 
file formats, including VIEW and First Word Plus, switching to it from other programs has never been 
easier. 
Power, flexibility, speed, ease of use. PipeDream 3. Breaking down the barriers. 
For a free brochure, see your Archimedes dealer, or phone us on 0954 211472 or return the coupon. 
PipeDream 3 is for all Archimedes computers with RISC OS and 1Mbyte of RAM. 
PipeDream 3 costs £147.00 +VAT. 


Majer features include: 
many documents loaded at once 


intuitive RISC O5 user interface 
displaying and printing 
of pictures within text 
built-in 93,003 word 
spelling checker 

file compatibility with 

PC & Z88 PipeDream and 
BBC View Professional 
background recalculation 
keystroke compatibility 
with 288 & PC PipeDream 
Z88 filing system 


automatic loading of VIEW, 
ViewSheet, Lotus, First Word For a free brochure, complete and retum this coupon 
Plus, Tab and CSV files | PipeDream 3.0 View Professional [-) | 
automatic saving of VIEW, | Name | 
Lotus, Acorn DTP format, Tab jAddrens | 
and CSV files es 
multi-field sorting | | 
| 
| 
| 


use of all available fonts | Post code 

62 spreadsheet functions 

external references for 3-D | Colton Software, Broadway House,}49-151 St. Neots 
modelling jRoed. Hardwick, Cambridge CB3 7QJ, England. 
macro file recorder Fax: 0954 211607 Tel: 0954 211472 

slot protection L 


All trademarks aclonowded ged The chart on the screen shown above wan prodwced by sending numbers from Pipellrcam 3 to Lingemwity t Presenter 2 and then lating the rmultning graph 


back into PrpeDream 3 


Colton Software, Broadway House, 149-151 St. Neots Road, Hardwick, Cambridge, CB3 7QJ, England 


Fax. 0954 211607 Tel. 0954 211472 


Tempest 


Clive Gringras reviews the latest addition to the range of DTP 


packages for the Arc. 


A yee ago there was an epidemic of art 
packages for the Archimedes. Now that the 
quality of dot-matrix printers has improved, 
and the price of fast laser printers has fallen 
below a thousand pounds, people are 
realizing the potential of the Arc in the 
Desktop Publishing (DTP) sector. The 
market now has four DTP packages 
available. Initially Acorn produced the 
pedestrian but sturdy Acorn DTP. After 
some appropriately impressive advertising, 
in November of last year Computer 
Concepts finally released Impression. More 
recently, BEEBUG’s Ovation has been 
greeted with much enthusiasm for being a 
professional, value-for-money product. 


"Fierce raged the 
Tempest..." 
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Tempest - editing a document 


THE PACKAGE 


This month sees the launch of Clares’ 
Tempest. On initial inspection Clares seems 
to have broken away from the established 
pattern - the package doesn’t come in a box 
containing an oversized filofax as a manual! 
The copy supplied for review was a pre- 
release version, and this should be borne in 
mind when reading the review, since many 
promised features have not yet been 
implemented. The package comes in a slim 
wallet, in the standard Clares style, 
containing function key strips and three 
discs. The full-release manual will be a ring- 
bound booklet which slots into the back. 
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One of the supporting discs contains some 
800K of clip-art from Midnight Graphics in 
Draw file format. This is all of a very high 
standard and includes numerous borders 
and arrows as well as a selection of animals 
and food. Clares also includes five printer 
drivers, a new modes module, some scanned 
artwork and a set of fonts (Corpus, 
Homerton, Trinity, Pembroke and Bullets). 
There seems to be little here to revolutionise 
DTP, though this is not necessarily a bad 
thing. Too often companies seem determined 
to be different just for the sake of it. 


The biggest fallacy concerning DTP is 
that the better the package, the better the 
output. Into the Arc (RISC User Volume 3 
Issue 3) showed how it is perfectly possible, 
using Draw and Edit on a 310, to produce 
an identical copy of a document to one 
produced with a DTP package on a 440. It 
will take far longer and need more trial and 
error to get the desired result, but it is 
possible. A DTP package will, however, be 
generally easier on the nerves, and 
Tempest’s author, Dave Coathupe, has 
succeeded in writing a package which will 
produce many different kinds of document 
with as little effort and fuss as possible. 


When reading this description of the 
package, however, it is essential to bear in 
mind that this is a review of Tempest, not a 
comparative review of DTP packages. Most 
of the packages on the market offer similar 
features, and their presence in Tempest 
should not be taken to imply that they are 
absent, or even less well implemented, in 
the others. 


USER-FRIENDLY FEATURES 
A facility is provided to enable the 
computer to save away the file you are 
working on at regular intervals. This isn’t 
just a reminder that flashes on the screen, 
which most of us would ignore and regret 
later. An actual window containing the 
filename appears on the screen ready to 
save. All you have to do is click on OK to do 
so. I now consider this auto-save to be 
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essential - why rely on my irregular backups 
when the computer counts in milliseconds! 


The on-screen ruler can be moved 
around the page and actually scales when 
you change the page magnification. This 
saves the obligatory draft printout to check 
that all your measurements are correct. The 
ruler can be calibrated in a number of 
different units, down to point size. 


DTP packages normally permit you to 
alter the magnification at which the page is 
shown on the screen. Often this is achieved 
by giving the user a choice of percentage 
scaling factors. This method of scaling is 
adequate when you are always working with 
the same size master page. However, 
Tempest includes a scale to fit option that is 
far more useful. Whatever the size of the 
page, one keypress can give the optimum 
magnification. A document you are 
currently working on might have the page 
scaled to fit widthways, thereby giving you 
the maximum clarity to work on. 
Unfortunately, this will not provide the full 
height page for overview purposes, so by 
pressing a function key the whole page is 
shown at its maximum size without any 
edges being lost. Additionally Tempest is 
due to include a double page fit. 
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Tempest - using the Auto save facility 


USING TEMPEST 

Tempest is a multi-tasking RISC OS 
application as you would expect. Once a 
document window is open, the program 


operates from a main menu. Most of the 
functions you would expect to find are 
accessible from the main menu, and many 
short cuts are available by using function keys. 


Tempest allows customised frames and 
styles, which can be set up with great ease. 
By simply pressing Select anywhere on a 
page a frame border appears which can be 
re-sized before dropping onto the page. This 
page outline is shown by a series of dotted 
green lines. Any subsequent re-sizing, either 
before text is in the frame or after, is 
accomplished by dragging one of the eight 
“ears” on each frame. The entire frame can 
also be moved using the mouse. All frames 
can have a background of any colour, and a 
border from a built-in selection. In the final 
release version you will also be able to use 
your own borders around frames. 


All text or pictures, as with all DTP 
packages, must be entirely within a frame. 
These may be either text frames or picture 
frames, but the two cannot be present in the 
same frame. Text may be typed in, or 
imported as ASCII, Edit, Graphic Writer or 
lst Word Plus files. Other word processors 
will be supported later. Picture frames allow 
the standard cropping and re-scaling of 
either Draw files (line art) or sprites 
(bitmaps). All you have to do is drag the 
frame's ears to the required position, select 
Fit to frame in the picture frame dialogue 
box, and the picture is immediately re- 
scaled. Although not implemented in this 
version, Tempest promises a rotation facility 
for Draw files from within the package. 


ADVANCED FEATURES 

Clares has also implemented some more 
advanced and professional frame features. A 
text frame can be divided into columns like 
this page without having the headache of 
having to draw two parallel linked frames. 
You may create a text frame and then 
specify as many columns as you like within 
it. It also provides full control over the 
spacing between the columns. The most 
powerful frame feature is Tempest’s frame- 
linkage capabilities. These allow everything 
from simple flowing text linkage to cluster 
links (parent-and-children frames) and 
hierarchical chain links. These powerful 
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features allow you to copy and move linked 
frames as a group. 


The style menu provides a simple method 
of defining a typeface and layout, via a Style 
editor window. This allows full control over 
the font, and the size, spacing and 
justification. Once defined, a style can be 
given a unique name and is automatically 
given a function key short-cut. Any style can 
be edited at any time, for example to change 
the font size. The pre-release version 
supplied for review has features in the style 
editor that are not yet fully implemented. 
These are Comprehensive leading, Indents, 
Bullets and Tag reference. 


All text can now use any one of the 
styles you have created as you type. Also a 
section of text can be selected by dragging 
the mouse pointer over it. This can then be 
deleted or moved, pasted elsewhere or have 
another style applied to it. 


A vital time-saving aspect of DTP and 
word processing is the ability to use macros. 
These are abbreviations which can be used 
in headers and footers and which are 
expanded during printing. For example, 
page numbering is generally handled 
automatically with a simple macro. Tempest 
has a multitude of other such macros, 
including the date, the time, the day of the 
week, the document name and the station 
number (for a network). 


Tempest seems very fast in operation. 
Moving between pages in a document using 
the Page Up and Page Down keys is almost 
instantaneous, With the font cache set to a 
comparatively low value of 128K there 
seemed to be no delay in screening the next 
page. Scaling and cropping of Draw files and 
sprites shows very little calculation time 
and the text rendering does not lag behind 
the actual input. However, when in full 
justification mode, text to the left of the 
caret on the same line appears to jockey for 
position every time you type another 
character. This can prove quite annoying 
but is easily avoided by justifying the entire 
text after you have finished typing. 


The program works well on an 
unexpanded 310 and a resources option is 
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available to be used like a mini Task 
Manager. This enables you to re-allocate 
memory to different areas of the program 
depending on what sort of work you are 
doing. 


CONCLUSIONS 


Although even the most expensive 
Archimedes DTP package looks a bargain 
compared to the likes of Aldus Pagemaker on 
a PC, price is a very serious consideration 
when buying software. However, this alone is 
not the sole criterion. Possibly more than any 
other computerised application, a DTP 
package should be chosen to suit your own 
specific requirements and preferred methods 
of working, and you should therefore make 
every effort to try out the various contenders 
before making your choice. One small piece of 
advice though: if you cannot choose on any 
other considerations, choose the product with 
the most helpful manual, The amount you 
can unwittingly spend by making long 
distance phone calls to the software technical 
department and making unwanted trips to 
your stockist to “sort out a little problem” 
invariably costs more than the price 
difference you might have tried to avoid. 


Prior to using Tempest I was convinced 
there was no place for a fourth DTP package 
on the Archimedes, especially as the other 
three are so strong. However, Tempest is not 
only user-friendly, but should be coined 
“user-helpful”. Provided that all the 
promised features materialise, the product 
is a reasonable contender in terms of price, 
but bear in mind that most of the features I 
have described are not unique to Tempest, 
and you should certainly see the other 
competitors before making a choice. 


Tempest 

Clares Micro Supplies 

98 Middlewich Road, 
Northwich, Cheshire 

CW9 7DA 

Tel. (0606) 48511 

£129.95 Inc. VAT 
(education £99.95 inc. VAT) 


Product 
Supplier 


Price 


Clares has announced that the price of 
Tempest is likely to rise in September to 
reflect the many enhancements which have 
been made during program development. 
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RISC User 
Volume 3 Special Disc 


Next month we will celebrate the successful completion of the third year of publication of RISC User magazine. 
To mark this occasion we will be launching a Volume 3 Special Disc which will be available with the first issue of 
Volume 4 at a special members’ price of £4.75 (non-members' price £15.00). 


The Special Disc will contain a selection of the best programs published throughout the ten issues of Volume 3, 
updated where appropriate, plus a selection of new and specially written items. 
Here are some of the items included on the Special Disk: 


Sticky BackDrop - place icons anywhere on the desktop and use your favourite 
screen picture as a background 

Amaze - a graphically superb and entertaining game 

Watchdog Anti-Virus - protect your hard and floppy discs from viruses 

Wimp Front End for the Basic Editor 

Desktop PC disc reader *NEW” - allows you to drag files to and from a PC directory 
viewer, format PC discs and much more 


Background Text Printer (with international character facilities) 
Keystrip Generator (both 9- and 24- pin versions) 
Encode - a file encryption utility 
CMOS RAM Manager 
NEW" Samples of clip-art from Beebug's highly successful DTP package Ovation 
A selection of the best Maestro music files 
A complete set of ArcScan data for Volume 3 
and more... 


The full details of this disc, packed with goodies for all Archimedes users, will be revealed next month. 
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RISC User Volumes 1 - 2 “|! | Fast ARM Code searching 
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Z logic. All finds in RISC User will be instantly displayed. You can now call up the Acorn Manuals 
A user-defined pari a indexes and repeat the search to get further references. 
allows easy customisation 2. To find the SWI name for SWI &400D4, select the new Programmers Reference Manual 
for other data. from the menu, enter “SW! &400D4", and the answer appears, complete with page references. 


AreSean i Dise + manual £14.95 members (£18.95 non-members) Code 0109A ArcScan Upgrade £7.95 members (£10.95 non-members) Code 0110A 
Please add 60ppip. For upgrade, please stale month ol purchase of AU Special Disc. 
Phone your order now on (0727) 40303 or send your chequa/postal onder to the address below. Please quole your name and membership number. When ordering by 
Access, Visa or Connect, please quote your card number and the expiry date. 


BEEBUG Ltd, 117 Hatfield Road, St Albans, Herts AL1 4J/S. Telephone (0727) 40303, 
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Tiger 


Add descriptive information to your files with Graham Crow’s 


application. 


For reasons of space, this program is 
supplied on the monthly magazine disc only. 


Tiger is a RISC OS multi-tasking 
application. Its name suggests a big cat 
(extended CATalogue!), and it provides the 
means of adding, editing and saving 
descriptions for each object in a directory. 
Descriptions may be up to 100 characters 
long, and are saved in a TigerData file in 
the relevant directory. 
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Tiger Data File 


The contents of a directory may simply 
be dragged into the Tiger window, and 
once there, a menu provides the means of 
traversing the directory hierarchy. Any 
executable object may be run by double 
clicking on it in the normal way. You may 
add or edit descriptions at any time and 
use Tiger’s menu to save or print them. 


EXAMPLE OF THE USE OF TIGER 


You are using 1st Word Plus to write 
a letter. Having done so, you need to 
choose a filename under which to save it. 
You might decide on “06-12-Gree” to 
indicate the month, day and partial name. 
Now you can drag the files into the Tiger 
window and add, say, “6/12/89. Letter to 
Alan Green to request dates of 
forthcoming exhibitions”. Bring up Tiger’s 
menu and click on Save. Later, when you 
display these files in the Tiger window, 
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the full description will automatically 
appear, reminding you of the details of the 
letter. To invoke 1st Word Plus and load 
the file just double-click on its name. 


INVOKING TIGER 

Tiger can be installed by double- 
clicking on either the application (!Tiger) 
or a data file (TigerData). The icon will 
appear on the icon bar, and a window is 
opened. If you clicked on a TigerData file, 
it will be loaded into the window. 
Otherwise you can drag any object from a 
directory viewer into either the Tiger 
window, or onto the icon bar icon, and that 
directory will be displayed, Subject to 
available memory, you may have more 
than one copy of Tiger installed, and thus 
more than one viewer open at a time. 


The window shows the object name, 
type, and description. A single click on the 
object-name selects and highlights it. A 
double click has the following effects: if the 
object is executable (a file or application) 
then it is run; if it is a directory, then its 
contents are loaded into Tiger. 


Clicking on the object type opens a 
window giving more information about the 
object (filetype number, size, attributes 
and datestamp) while the description 
column holds the text describing the 
object. Descriptions can be copied to 
another position in the window, which is 
useful if you have a number of files with 
similar descriptions. 


THE TIGER MENU 

The Tiger menu allows you to load the 
contents of the parent directory, save the 
current descriptions as a TigerData file, 
open the filer’s directory viewer for the 
displayed directory (giving immediate access 
to other RISC OS filing system functions 
such as copying and deleting), and print out 
the displayed directory in condensed print 
on an Epson-compatible printer. 


Full details on how to use Tiger are 
given on the magazine disc. ay 
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Assembler Workshop 
An Introduction to Heap Management 


David Spencer examines some important techniques of memory 
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management. 

C onsider the memory requirements of 
a desktop publishing program. The total 
memory needed can be split into two 
parts, that for the program, the size of 
which is unlikely to change while running, 
and the workspace needed for the program 
to run. This workspace can be further split 
into two - an area of fixed size containing 
various global variables used by the 
program, and a variable size area used to 
contain the current documents (in 
practice, there will be a third requirement 
for a stack and local variables). 


Figure 1. A simple heap with two chunks allocated 


The memory for the program and fixed 
workspace can be allocated when the 
program is first loaded, but how do we 
address the situation of a variably sized 
area? What’s needed is a method of 
obtaining memory on demand from some 
place or the other, and returning it when 
no longer needed, Then, for example, our 
DTP program could claim memory as text 
is entered, and free it again as text is 
deleted. 


All this can be implemented using a 
very important data structure called a 
heap. The idea of a heap is simple - an 
area of memory out of which smaller sized 
blocks can be claimed. There is also 
normally a header at the start of the heap 
to identify it as a heap and indicate 
certain attributes, such as the size of the 
heap. 


When a heap is first created it will be 
empty, with just the header present. When 
the application wants a certain sized block 
of memory, it requests it through a piece of 
software called the Heap Manager. The 
Heap Manager will then allocate a chunk 
of the heap area and return a pointer to 
this (in other words the address of the 
start of the chunk). Figure 1 shows a heap 
with two chunks allocated. When the 
chunk is no longer needed, another call to 
the Heap Manager releases the chunk, 
where upon the Heap Manager returns it 
to the pool of free 
heap space from 
where it can be 
claimed by a 
subsequent call to 
allocate a new 
chunk. 


When a chunk 
of heap memory is 
released it will 
normally leave a 
‘hole’ of free space in the heap. This is 
because the Heap Manager cannot alter 
the position of other chunks as the 
application using them may have set up 
pointers to locations within the chunk. 
The best that can be done is to combine 
adjacent free blocks whenever they occur 
to give a larger block. Instead, the Heap 
Manager maintains a list of all the free 
areas within the heap. When a request is 
made for a new chunk the Heap Manager 
must decide whether to allocate the chunk 
in one of the free holes, or to use the free 
memory after the currently allocated 
chunks. This is not always a simple 
decision, Suppose for example that a 100 
byte long hole exists and a request is 
made for 90 bytes. If the Heap Manager 
fits it into the hole, then you are left with 
a 10 byte hole which may be too small to 
be put to any use. Worse still, the next 
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request may be for a 100 byte chunk, 
which would have fitted perfectly into the 
hole. One of the major problems to 
overcome when implementing a Heap 
Manager is to design an allocation 
strategy that avoids the heap being 
fragmented with lots of small areas of free 
space - not an easy task. 


Sliding Heap 


Anchor 


Figure 2. The function of an anchor point in a sliding heap 


THE RISC OS HEAP MANAGER 


By now, you are probably thinking that 
however useful a heap may be, the work 
involved in implementing a Heap 
Manager is just too much. Luckily though, 
RISC OS comes to the rescue as it already 
includes a built-in Heap Manager. 
However, the reason for this is not 
primarily to make the programmer’s job 
easier, but rather because RISC OS itself 
makes extensive use of a number of 
different heaps. Indeed, the relocatable 
module area is implemented as one large 
heap. 


Access to the RISC OS Heap Manager 
is via a single SWI call - SWI "OS_Heap". 
This takes a reason code in register RO to 
indicate what operation to perform on a 
heap, and also takes various other 
parameters depending on the operation. 
We will now look at all the heap 
operations provided and show how they 
can be used to create and maintain a 
heap. All examples are given in Basic for 
clarity, but the techniques can easily be 
translated to ARM code. 
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Pointer in 
application program 


Clearly the first operation must be to 
create a new heap. This is done using the 
call: 

SYS "OS_Heap",0,start_address, size 
which creates a heap of length size bytes 
starting at start_address. This cal] starts 
by checking that the start address and 
length are sensible values (both must be 
word-aligned inciden- 
tally), and then builds 
up the heap header, or 
descriptor as it is often 
called. 


Having created a 
heap, it is now possible 
to claim and release 
chunks from it; 
Claiming is done using 
the call: 

SYS "OS _Heap",2,start 
_address,,length TO ,, 
pointer 
start_address is the address of the heap as 
specified when it was created. This allows 
RISC OS to locate the heap descriptor, 
and allows for multiple heaps at different 
addresses. length is the length in bytes of 
the chunk to be claimed. Assuming that 
the chunk could be accommodated in the 
heap, a pointer to it is returned as pointer. 
On the other hand, if there was 
insufficient room in the heap, an error will 
be generated. This can be trapped by 
using the X form of the SWI, in which case 
pointer is set to zero to indicate that no 
chunk was allocated. A chunk is freed 
using: 

SYS "OS Heap", 35 start_address, pointer 
start_address is once again the address of 
the heap, and pointer is the address of the 
chunk being freed. 


A call exists to read the size of a given 
chunk, and this is: 
SYS "OS_Heap",6,start_address, pointer 
TO ,,, length 


start_address and pointer are as above, 
and length returns the current length of 
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the chunk. The size of a chunk can be 
altered by using the call: 
SYS "OS Heap", 4, start_address, pointe 
r,size_change TO ,,new pointer 

size_change is the amount by which to 
change the size, and can be positive to 
enlarge the chunk, and negative to shrink 
it. Enlarging a chunk may involve moving 
it, in which case the Heap Manager moves 
the contents automatically, and returns a 
new pointer to the chunk in new_pointer. 
If this happens, it is up to the application 
to relocate any pointers to locations within 
the chunk, as these will now have 
changed. 


The final two operations concern the 
heap as a whole. The first of these is used 
to find out how much free memory is left 
in the heap, and how large the largest free 
block is (this determining the largest 
chunk that can be allocated). This call 
takes the form: 

SYS "OS Heap",1,start_address TO,,lar 

gest_block, total free 
Again, start_address is the start address if 
the heap, and the results largest_block 
and total_free are as just described. 
Finally, the size of the heap as a whole can 
be changed using the call: 

SYS “OS Heap",5,start_address,,size_ 

change 

start_address points to the heap, and 
size_change is the amount by which to 
change the size - positive to expand the 
heap, negative to contract it. This call will 
never move any allocated chunks, and 
therefore an error is given if an attempt is 
made to contract the heap so much that it 
can’t accommodate the current chunks. 


DIFFERENT TYPES OF HEAP 
There are a number of different types 
of heap in addition to the type already 
described. The problem with this simple 
type is that it starts with a fixed pool of 
memory, the size of which cannot be 
changed automatically. Therefore, if a 
claim is made for a block of memory that 
is larger than is available then an error is 


given. It is however possible for the user’s 
program to try and extend the heap itself 
(through the heap manager) and then try 
the claim again. 


While a simple heap is useful in an 
environment where a fixed amount of 
memory is available, it is not so useful in 
a multi-tasking system. The problem is 
that any unused memory gets tied up in 
the heap and cannot be claimed by any 
other applications. For example, consider 
our DTP program again. It might initially 
set up a heap large enough to contain 
twenty full pages of text. Even if you only 
typed two pages, the storage for another 
eighteen is still tied up and unavailable 
for other applications. 


One solution to this is to modify our 
heap in the following way: Firstly, start 
with very little memory allocated to the 
heap. Then, design the heap manager in 
such a way that it can claim further 
memory (probably from the Wimp’s free 
pool) as needed. When it comes to 
releasing chunks, we run into the same 
problem as with the simple heap - namely 
holes appearing in the middle. However, 
after a chunk is released, any free memory 
at the end of the heap can be released 
back to the Wimp for use by other 
applications, as this will not affect any 
other chunks. How effective this is 
depends on the size of the chunks in the 
heap, and the order in which they are 
claimed and released. Inevitably though, 
memory will still be lost as free space 
buried in the heap. We will refer to this 
type of heap as a Contracting Heap. 


The creme de la creme of heaps, so to 
speak, is the so-called Sliding Heap. The 
principle is fairly simple - whenever a 
chunk is released all the chunks after it 
are moved down to fill the hole, and the 
free memory, which will move to the end of 
the heap, is released back to the Wimp. 
Unfortunately, this opens up a whole host 
of problems, as the application now has to 
cope with the possibility that the address 
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of each chunk can change. To allow for 
this, the mechanism for claiming and 
releasing a heap block is changed slightly. 
Instead of the Heap Manager returning a 
pointer to the chunk when it is claimed, 
and the application using this to release 
it, a pointer to a pointer is used. This will 
be clearer if you refer to figure 2. The 
Heap Manager allocates a chunk and 
stores a pointer to it (its address) in a 
memory location somewhere outside the 
heap. It then returns to the application, 
not the address of the heap chunk, but the 
address of the word containing the 
address of the heap chunk. 


When the Heap Manager slides a 
chunk around, it can update the location 
containing the address of the chunk 
pointer without having to involve the 
application. When the application wants 
to access data within a chunk it must first 
read the address of that chunk using the 
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pointer to the location where it is stored 
(called the anchor point), and then add an 
offset to this address to locate the required 
data. As the chunk can move around, 
special care needs to be taken with 
pointers that point directly to data within 
the chunk. In general, the application 
must work with offsets from the start of 
the chunk, rather than absolute 
addresses. 


An example of a sliding heap is the flex 
heap manager which forms part of the 
RISC OS library in Acorn ANSI C. This is 
used by applications such as Edit, Draw 
and Paint to control their memory 
allocation. 


In next month’s Assembler Workshop 
we will present a Heap Manager program 
to implement the contracting type of heap 
and also show how heaps can be put to 
practical use in your own programs. my 


- THE Archie 
art package! 


* User defined brush 

* Now with INTEGREX dump and rotate routine 
* Used in education all around the UK 

* Education users please contact us for discounts 
* ONLY £19.99 inclusive! (cheques & P/Os) 


"Upon loading Flare, the friendliness of the program almost shakes you by the hand... 
..in spite of its simplicity of use, the program is capable of producing sophisticated imagery. 
Students using this program have all found it instantly likeable... 
.. with no problems finding their way around, even without tuition... 
FLARE IS EXCELLENT VALUE FOR MONEY and delightfully user friendly," 


THE TIMES EDUCATIONAL SUPPLEMENT 15/6/90 


DESKTOP CC - an easy to use WIMP front end for the Acorn C compiler (release 3) ONLY £14.99 


FROM: SILICA SOFTWARE SYSTEMS, MALLARDS, LOWER HARDRES, CANTERBURY, KENT, CT4 SNU 
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Beebug Hardware Upgrades for the A3000 


BEEBUG BEEBUG 
A3000 Disc Buffer A3000 Memory Upgrades x 


An exciting new release for the A3000 allowing The BEEBUG A3000 memory upgrades are 
the connection of 5.25" drives to the A3000, Some available in either 1 or 3 Mb versions and are easy 


of the features include: to fit by the user. This will give a total of either 

4 Connector for BBC-type 5.25" & 3.5" drives aNtb ora massive 4Mb of memory: 

4 On board switches allow drive mapping to be By using the latest surface mount technology we 
changed. eg. The internal drive could be made have achieved a board size of a mere 256x46 mm. 


drive 1, and an extemal drive as drive 0 - ideal The 1 Mb board can be easily upgraded to 3 Mb at 


for the PC emulator ; 
- any time by the user, unlike some other boards on 
4 Whole interface contained on an internal card te = ark es 


O Easy to fit, supplied with full instructions 

QO Will work with most drives that have an internal Q Easy to install with fitting instructions provided 
Power Supply Unit Q Full 12 months warranty 

Q Can read DFS files with optional DFS Reader Q 1 Mb expandable to 3Mb by the user 

O Internal and external drives can be double O uses latest surface mount technology 
stepped to read 40 track discs O Free fitting (by appointment if required 


QO) Full 12 th rs 
ma RES WERT 0130D Beebug A3000 Memory 1Mb £149.95 


0135C A3000 buffer 0131D Beebug A3000 Memory 3Mb £349.95 
0102B DFS reader i 0132C 1Mb to 3Mb upgrade £209.95 


* NEW lower prices! 


45Mb Removable Hard Disk System 


The SCSI Hard Disk System that offers: 


Security - Lock away valuable data in your safe 
Unlimited Storage - System expands with your needs 
Fast Data Transfer - Load programs at 650Kb per second 
Reliability - Typically 30,000 hours between failures 
Fast Access - Faster than a conventional hard disk 
Portability - Carry your programs and data with you 
Write Protect 45Mb - Just flip the tab 


These SCSI drives are specifically configured for maximum 
performance when used with Acorn Archimedes computers 


Removable Disk Drive £74 45Mb Disk Cartridge 779 


Includes Drive, Cables and Disk Cartridge These are the size of a CO case 


The Electric Scribe Co. Ltd 


@ 23 Justice Mill Lane, Aberdeen AB1 2EQ 
® Telephone: (0224) 211907 Fax: 211908 


All prices are exclusive of VAT but include delivery 
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Introducing C (Part 4) 


by Dec McSweeney 


i the last issue we examined some of 
both the differences and the similarities 
between C and Basic. This time we will 
begin by extending our knowledge of C 
facilities and syntax in order to tackle a 
more sensible problem. 


THE ROOT OF THE PROBLEM 

The basis of our discussion will be a C 
program to calculate the square root of a 
number, a relatively trivial problem but one 
which enables us to see a variety of new ‘C’ 
constructs in action. We present the 
program here in its entirety before 
discussing its individual features. In 
particular, the example illustrates the use of 
some of C’s flow control commands, and the 
use of variables. 


We shall be following the syntax in all 
our examples required by ANSI C. Note that 
there are some small differences between 
this and C as defined by its originators, 
Kernighan & Ritchie in their definitive book 
on C. 


/* sqt.c - calculate the square root of a number */ 
#include <stdio.h> 

#define ACCURACY 1.0E-6 

double sqt(float); 


Int main(vold) 
float n; 


printf("give me a number; "); 
scanf("%f", &n); 


while(n {= 0) 


{ 
printf("You entered %f", n); 
printf(" square = %f", n*n); 
If(n > 0) 
printf(" root = %f \n", sqt(n)); 
else 
printt(" *** Negative - no real root ***\n"); 
printf("give me a number; "); 
scan{("%!", &n); 
} 
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} 

double sqt(float num) 

{ 

double ans, acc; 

acc=ans=num/2.0; 

while(ans > 0 && acc > ACCURACY) 
{ 


ans=(ans+(num/ans))/2.0; 
acc=num - (ans‘ans); 
if(ace < 0) 
ace = -acc; 
} 
return ans; 


} 


The first line is comment, the second is 
the #include preprocessor command we saw 
earlier, but the third line is new. It is 
another preprocessor command, #define; 
this causes all occurrences of the first word 
(throughout the source program) to be 
expanded to the value of the rest of the line. 
This is useful for large programs using a 
constant value in many places which is 
subject to change, such as VAT rate, 
currency symbol, and so on - you only need 
to change it in one place. Here we use it to 
define the accuracy required in our 
calculation. The notation might be familiar 
to you, it means "1.0 times 10 to the -6th 
power”, or 0.000001. 


The fourth line is a function prototype; it 
tells the compiler that a function, sqt, exists 
in the program which returns a value of 
type double, and takes one parameter, of 
type float. ‘double’ stands for ‘double 
precision floating point’; in earlier versions 
of C it was also known as ‘long float’. 
Specifying a prototype allows the compiler 
to check that all calls to the function have 
the right number and type of parameters. 
I’ve called the function sqt, by the way, to 
avoid a name clash with the function sqrt(), 
which is supplied as standard with all 
implementations of C. 


As a function itself, main() must have a 
return type. main() is expected to return an 


39 


Introducing C (Part 4) 


40 


integer (normally used to return an error 
code). main() has no parameters, but in 
ANSI C it is essential to specify this by 
putting ‘void’ where the arguments would 
normally go. 


After the opening brace which marks the 
start of the program proper, a variable of 
type float, n, is defined. This is followed by a 
simple printf) to ask the user for input, and 
a call to scanft), the C equivalent of Basic’s 
INPUT. scanf() takes as its arguments a 
conversion string ("%f" in the above 
example) and the address(es) of the data to 
be entered - "&n" translates as ‘the address 
of n’, We'll be looking at addresses and 
pointers in detail later. Strictly speaking, 
scanf() fetches the data from the ‘standard 
input stream’, but this will normally be the 
keyboard. 


Then a new iterative construct - while(). 
This is similar to WHILE in Basic; the 
expression in brackets after while is 
evaluated; if it is TRUE (or non-zero) the 
group of statements is executed. This 
process repeats until the expression 
evaluates as FALSE (or zero). Note that if 
the expression is FALSE to begin with, the 
statements are never executed. This would 
happen if the user entered 0 when first 
prompted (in C the notation "!" means 
"NOT"). 


On the next two lines, the value entered 
and its square are printed. Then the value 
of n is tested. iff) works much like the Basic 
equivalent; if the expression evaluates as 
TRUE (non-zero), the statement (or group of 
statements) is executed, otherwise the 
statement(s) following the optional else are 
executed. Processing continues from the 
statement after the else statements. 


In this case, if n is negative a message is 
printed, otherwise we print the value 
returned by the function sqt with n as its 
parameter ("%f" is the floating point 
equivalent of "%d", by the way). To evaluate 
this, C passes a copy of the value held in n 
(‘call by value’, an important property of C), 
executes the statements in sgt and comes 
back with the calculated answer. The loop 


ends with another prompt for input, and 
processing continues until the user enters 
zero. The program terminates at the closing 
brace of main(). 


sgt is a separate function, and starts as 
all functions must, with its return type, its 
name, and any parameter declarations 
(naturally, the definition of a function must 
agree with its prototype at the start of the 
program). In this case the return type is 
double, its name is sqt, and its one parameter 
is of type float and is called num. In our 
example, num will contain a copy of n. 


At the start of sq some more variables 
are defined and initialised. These variables 
are local to the function, and are called into 
existence for the duration of each call - the 
variable ans, for example, doesn’t exist as 
far as main() is concerned. Nor does it retain 
its value between calls. Note the technique 
for assigning a value to more than one 
variable. 


The first statement of sgt is another 
while loop. In this case, the loop will repeat 
as long as ans is greater than zero AND our 
accuracy requirements are not met (note the 
"&&" for the logical "AND" in C - as opposed 
to the single "&" for bitwise "AND”). The 
test for zero is to avoid a divide by zero 
within the loop. Unlike Basic, C can’t trap 
this for you tidily, and produces some fairly 
severe-looking messages if it doesn’t just die 
on you! At the end of the loop, acc is made 
positive, in an operation equivalent to 
Basic’s ABS(acc). 


The sqt function uses an iterative 
method for obtaining a root, and this 
consists of refining a guess at the square 
root of num until the required accuracy is 
attained. Try out the arithmetic with a 
calculator if you like; the arithmetic 
operators and brackets within the loop 
mean the same as in Basic. 


When either condition is satisfied, the 
function sends the answer back with 
return(ans). The value so obtained is passed 
to printf0 for display upon the screen (more 
strictly the ‘standard output stream’, which 


RISC User October 1990 


Introducing C (Part 4) 


is normally the screen but which can be 
redirected to a file). 


Compilation and running is as 
straightforward as with last month’s ‘Hello’ 
programs. If you run the program, however, 
you will find a limitation C shares with 
Basic; floating point numbers are held to an 
accuracy of about nine digits, which causes 
inaccuracies in the least significant digits of 
large numbers. This may be avoided by 
checking that the user’s input is both 
positive and less than a certain threshold, 
by changing the if statement in main() to 
read: 


If(n > 0 && mn <= MAXNUM) 
printf(" root = %f \n", sqt(n)); 
else 
printf(" *** Negative or too big - can't do 
“"\n"); 


where MAXNUM could be #defined like 
ACCURACY (remember that "&&" means 
"AND"). 


You may be wondering why #define is 
used. Using ‘magic numbers’ in the source is 
bad for portability, as MAXNUM depends on 
the implementation, and might be different 
on another machine. Hence we set these 
things out at the top of our program, or even 
in a header file. On another machine or with 
another compiler we could either amend the 
source or use the ‘local’ version of the header 
file. 


We'll return to sgt in the future, and 
refine it to reduce its limitations. Now I'd 
like to turn to character variables. 


CHARACTER HANDLING - 
STRINGS AND THINGS 

In Basic, there is a variable type string 
which holds 0 to 255 characters, preceded by 
a byte to hold the variable’s length. In C, as 
we mentioned in part 1, strings are dealt 
with as arrays of characters. The end of the 
string is marked by the character whose 
ASCII code is ‘0’ (null). This simplifies 
things in some ways, while complicating 
them in others. 
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In C, a variable of type char is defined as 
being at least big enough to hold any 
member of the machine's character set. The 
definition carefully avoids tying a char to a 
byte, and means you shouldn't make such 
an assumption in your programs. Many C 
programs, particularly earlier ones, use 
variables of type char to hold small 
unsigned numbers, and it is possible to do 
arithmetic on chars - “strong typing is for 
weak memories”, as the saying goes. This 
approach means we have done away with 
the basic functions ASC and CHR$ at a 
stroke. Look at the following Basic 
fragment, and compare it with the C 
fragment which follows it: 


REM Basic put "B® in newS 
num1%=ASC ("A") 
num2$=numl $+ 1 

newS=STRS (num24$) 


* C put "B" In new */ 
int num1, num2; 
char new; 

numi='A’; 
num2=++num1; 
new=num2; 


The new notation, ‘A’ is a character 
constant, defined as an integer with the 
numeric value of the quoted character in the 
machine’s character set. Almost everybody 
uses (broadly) the same character set 
(ASCID, but beware of assuming that lower- 
case letters are ‘greater’ than upper-case, or 
that the codes for A to Z are continuous. 
This is not true in EBCDIC, for example, 
which is in common use on IBM 
mainframes. 


As a matter of fact, the use of int above 
is superfluous, given that arithmetic can be 
performed on chars. A C programmer might 
write: 


/* put "B" In new - version 2 */ 
char new='A’; 
new++; 


This sort of thing won’t be completely 
new to you if you have used indirection in 
Basic. It could be said that C’s characters 
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operate in much the same way as Basic’s 
byte indirection while strings, being arrays 
of characters, are like Basic’s "$" indirection. 
This is where an area is set aside in the 
program to hold (in our case) a string: 


DIM mess 50 


Smess="Hello mum" 
character 
PRINT $mess 
mess?5=13 
PRINT $mess 


: REM result would be "Hello" 


In C, the code looks quite similar: 


char str[50); /* reserve 50 chars */ 
strepy(str, "Hello mum"); 
printf("%s\n", str); 
str[5}="\0"; 

printf("%s\n", str); 


The first line of the C example defines 
an array called str with 50 characters - note 
that C uses square brackets for array 
subscripts. The second uses a library 
function, strepy, to transfer the string into 
our array. Just as Basic adds a return 


: REM reserve 50 bytes for our string 
: REM insert data, OS adds Return after last 


: REM behaves much like a string variable 
: REM insert return at 6th char (byte indirection) 


/* copy message In - C terminates It with 0 */ 

/* print our message (we must supply new line) */ 
/* special character constant, equals null */ 

/* as before, result would be “Hello” */ 


The address of an array is held in a 
special variable called a pointer. Pointers, 
like ordinary variables, must have types - in 
the example above, the type is char. In fact, 
‘str’ itself is a pointer which holds the 
address of str[0). The 
address of str{1] may 
be expressed as 
str+1, and so on. 


The arguments 
passed to printf) and 
strepy() above are 
actually pointers to 
char. You can declare 
free-standing 
pointers like this: 


Intn; /* ordinary 
varlable */ 

Int ‘ip; /* pointer to 
int */ 


Pointers can hold the 
address of any variable of the same type: 


Ip = &n; /* Ip now points ton -"&" means "the 
address of" */ 


You can then use the variable name and the 


character, C adds a terminating null pointer interchangeably: 
character to the source string "Hello 
mum" which is copied into str. The third ‘ip=5; /* the same as "n= 5;" - "*" means the */ 


line prints it - "%s" is the conversion code 
for strings, and \n, which you’ve met 
before, adds the newline. Line 4 changes 
the contents of the sixth character (C 
arrays start at element 0). ‘\0’ is a special 
character constant, representing zero. 
Finally we print the altered string. 


The nth element of an array is accessed 
as str[n-1]. However, there is another useful 
notation which exploits one of C’s most 
powerful tools. 


C is a high-level language which allows 
complicated operations to be programmed in 
a small amount of human-readable code. 
However, it shares some characteristics 
with assembly languages, one of which is 
the ability to use the address of something, 
as well as its value. 


nsquared= ‘ip * *ip; 
printf("%d", ‘Ip); 


/* "value at the location pointed to by” */ 


Using the new notation with an array is 
quite logical: 


str[5]="\0'; 
is equivalent to: 
*(str + 5) = ‘\0'; 


The brackets are needed to force the 
expression on the left of the equals sign to 
evaluate correctly - "*str + 5" is "The 
contents of str{0], with 5 added” or in the 
above example ‘M’ (the ASCII value of the 
HH of ‘Hello’ plus 5). 
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More importantly, you can do a limited to the next element in the array. With 
amount of arithmetic with pointers. pointers, addition and subtraction are 
Remembering that a string is a zero- _ permitted, while multiplication and division 
terminated character array, the following are not, which is quite reasonable - think 
fragment will print the length of the string _ about it! 
in str: 


The expression temp - str is 
char str[512]; ot the re saben 
* ° ‘ the two addresses but the 
la Cee ert number of elements between 
scanf("%s”, str); /* stris the address of the start of the array */ | St and ¢emp-1 inclusive. In 
the case of character arrays 
this is indeed the same as the 
number of bytes, but a 
strength of C is that the basic 
unit of pointer arithmetic is 
the size of the object pointed 
The for loop is empty because all its to. We'll return to this topic in a later issue. 
work is done in the re-initialiser. The loop 
will exit when the central expression That’s it for this month. I hope you're not 
("*temp") evaluates to zero, that is when the _ too confused, but don’t worry - pointers and 
character pointed to by temp is null, which = arrays are the hardest parts of learning C. 
is at the end of the string. The expression Next month, more on pointers and arrays, 
temp++ simply increments temp so it points _and first steps in file handling. Hy 
FS 


for(temp = str; *temp; temp++) 


printf("this string Is %d characters long\n", temp - str); 


Base 


> 


BaseS DBMS is a unique kind of database management system specifically 
developed for the Archimedes. Unique, because it offers a complete database 
language and library, able to work from within your Basic programs. No 
“Tricksy” code has been used so all Base5 programs are fully compatible with 
Basic compilers. The comprehensive documentation contains an extensive 
tutorial as well as a language reference. A number of databases and programs are 


also supplied as example material. : 

More modules are being developed all the time and will be available to registered 
users at preferential prices. Registered users will also enjoy ONE YEARS FREE 
technical support! 


Base5 
£ 69 P O Box 378 


WOKING 
Inclusive of VAT, Postage & Packing Surrey GU21 4DF 
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New Archimedes Products from 
Software Solutions 


Carousel £39.95 Genindex £29.95 
Interactive presentations and rolling Create index files to enable faster 
demos from selected pages of your searching of your Genesis 
Genesis applications. applications. 

CD-Sharer £137.50 


Give several users access to a CD-ROM drive over the network. Share this high 
cost device and make more efficient use of your resources. 


Plus.... 


Genesis £86.95 


Create linked pages of information consisting of text, graphics, music and 
animation. 


"Genesis is a versatile tool....it offers immense power and potential for 
information handling." Dave Futcher - BBC Acorn User June 1990 


"Genesis is an impressive product that is certainly here to stay." 
Geoff Brown - Micro User May 1990 


Disc Sharer Printer Spooler Remote Logon 


The Dise Sharer (£137.50), Printer Spooler (£81.25) and Remote Logon (£38) 
make more economic use of the network than traditional file servers. Share hard 
discs and printers with several users whilst still using your computer for other things. 


All prices subject to VAT. Educational discount of 20% and site licences available. 


More information from: 


= Broadway House, 149-151 St Neots Road 
| S SOPTWARE) Hardwick, Cambridge CB3 7QJ 
= |SOLUTIONS Tel: 0954 211760 Fax: 0954 211767 


Slideshow 


Alan Wrigley reviews an application which turns your screenshots into 


| 


a continuous display. 


he concept behind Slideshow is a simple 
one. Take a number of full-screen sprites, string 
them together in a sequence, add a transition 
routine (cut/fade etc.) and you have a 
professional-looking sequence of pictures which 
can be used for almost any demonstration 
purpose, 


Picture Tine “7 


Hove Picture 


{aw Swap Position 


¢ Melete Picture 


Save Sequence 
Save Run Only Seq? 
be 


The main Slideshow window open on the 


desktop, with the picture menu visible 


Despite the simplicity of the concept, 
however, the software performs to a high 
standard and is delightfully simple to use. 
Double-clicking on the application's icon installs 
it on the icon bar, and clicking on this opens a 
large multi-tasking window. This contains a 
series of boxes, into which sprites can be 
dragged to form the sequence. The program 
runs in mode 15 only, but both mode 12 and 
mode 15 sprites can be mixed in the sequence. 
Only full-screen sprites can be used, but it is 
simple enough to create these in the first place 
by using either the *ScreenSave command or a 
utility such as RISC User’s Screen Freezer and 
Dumper (Volume 1 Issue 8), or for Desktop 
screens, Desktop Hotkeys (Volume 3 Issue 1). 


When a sprite is dragged into a box, it is 
displayed there at reduced size, so that you can 
see the pictures you have selected. Dragging a 
sprite into the next space causes a further box to 
appear between the two, which will show the 
transition routine selected. By default this is a 
simple cut (shown by a pair of scissors), but 
clicking Menu over the window and selecting New 
Transition offers you a choice of 44 different 
routines, ranging from Fade in which individual 
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pixels change randomly across the picture, to 
Horizontal Rebound, where horizontal bars sweep 
across the picture in each direction. 


The picture boxes also have a menu structure, 
allowing you to move, copy or delete a picture or to 
swap the positions of any two, You may also specify 
the time each picture is to appear on the screen 
when the sequence is run - this can be done 
individually for each one. The time selected is 
shown at the foot of the box. Alternatively, the fade 
can be activated by the user when the sequence is 
run. 


Above the main window is a pane which 
shows the total playing time and the amount of 
free memory left. Slideshow runs entirely from 
RAM with no disc accesses during a 
“performance”. This means that there is a finite 
limit to the number of pictures used, although 
sprites are compressed as they are loaded in, so 
even on a 1Mbyte machine you can get quite a 
few mode 12 screens into memory. However, if you 
copy a picture it takes up no extra memory, so 
may be a useful way of extending the length of a 
sequence if memory is tight. 


Sequences can be saved to disc, but even more 
useful is the facility to produce a run-only demo 
from the sequence. Slideshow automatically 
produces all the files necessary to make a stand- 
alone run-only application which can then be run 
without Slideshow being present. Run-only files 
may be freely distributed and may therefore be 
supplied as demonstrations to users who do not 
have a copy of Slideshow itself. 


This is a very nice little piece of software that 
is very easy to use and performed faultlessly. If you 
wish to make up demonstration sequences I can 
definitely recommend it. Bear in mind, however, 
that for long sequences you will find memory a 
limiting factor on a 1Mbyte machine, particularly if 
you are using complex mode 15 sprites. 


This month's magazine disc contains a run-only 
sequence compiled from pictures which have 
appeared on recent RISC User discs. 


Product 
Supplier 


LoncMAN LocotroN *# 


setting standards, meeting targets. 


WE ARE LOOKING FOR AUTHORS 


an You Program the ARM in Assembler ? Can You Write RISC OS applications in C, Pascal 
i or Compiled Basic ? Do you have a background in or a feel for the very best practice in the 
use of Computers in Schools ? Do you have an eye for detail and demand the highest standards 
of visual presentation in your work ? Have you experience of working with other software com- 
panies and feel you are not getting a top return for your efforts ? 


WE OFFER YOU THE BEST RATES OF ROYALTY IN THE BUSINESS 


We offer you the most professional marketing backup for your product. 


We publish your product with the highest quality documentation. 


We offer you privileged access to the highest quality, highest level of development 
information available in Cambridge, both formal and informal. 


IN SHORT, WE OFFER YOU ALL THE ADVANTAGES OF WORKING WITH 


THE BIGGEST EDUCATIONAL SOFTWARE PUBLISHER IN THE UK 


Over the next couple of months, Longman Logowon are actively seeking two or three top quality, 
generic, cross curricular RISC OS applications to add to our select list of Archimedes Products for 
1990-91. 


If you think you could be one of the two or three authors we are looking for, contact Julian Pixton 
- in complete confidence, on Cambridge (0223) 323656 now ! 


LONGMAN LOGOTRON - THE SOFTWARE MARKETING PROFESSIONALS | 


Publishers of : 
Archimedes Logo, Archimedes Pendown and Archimedes Numerator. 


LONGMAN LoGoTRON, DALes BREWERY, GWyDIR STREET, CAMBRIDGE, CB1 2LJ | 
TELEPHONE: (0223) 323656 FacsiMiLe: (0223) 460208 


Into the Arc 


Expansion Cards 


by Alan Wrigley 


i this month’s Into The Arc we will be 
considering expansion cards, or podules as 
they are commonly known. When the 
Archimedes was first launched, the word 
“nodule” was coined by Acorn to describe a 
plug-in module. Subsequently a more 
sober approach to designer names 
prevailed, and along with the change in 
the operating system from Arthur to RISC 
OS, the word “podule” was dropped in 
favour of “expansion card”, though the 
former name is still often used. 


Expansion cards provide the means to 
add hardware tothe imedes. They open 
up all sorts of possibilities for computer 
applications that would not be possible with 
the Arc’s circuitry alone. Some, but not all, 
interface to external equipment, which is 
then controlled by the Arc. The software to 
drive the podule may be supplied on disc, or 
it may be contained in an EPROM on the 
board itself. 


WHERE DO THEY GO? 

Expansion cards are designed to fit 
inside the computer, and space is provided 
for them to do so. It follows that any 
expansion card must conform exactly to 
the specifications regarding size and 
connecting sockets etc. The card is 
normally bolted or screwed to the rear of 
the computer in place of a removable 
backplate, and plugs into a socket inside 
the machine. On the A3000, there is space 
for one card only, and the socket is 
provided on the main circuit board. A3000 
cards have their connectors at right- 
angles to the card, and are not compatible 
with Archimedes cards. 


Expansion cards for the 400 series and 
the older 300 series, on the other hand, 
are interchangeable. On these machines, a 
backplane is required; this is simply a 
further board which plugs into the 
computer’s main circuit board and 
provides a standard multi-way socket 
facing the rear of the computer, into which 
expansion cards are plugged from the 
rear. 400 series machines are supplied 
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with a backplane already in place, 
whereas 300 series machines were not, 
and must have one fitted before they can 
accept expansion cards. 


The 300 and 400 series also differ from 
the A3000 in that more than one card may 
reside in the computer at the same time. 
Cards may be of two sizes, full width or half 
width, and they may be stacked one above 
the other in two rows. It is therefore 
possible to have up to four half width or two 
full width cards in the machine. 


WHAT DO THEY DO? 

The range of applications available 
from expansion cards is growing all the 
time. There are input/output podules, 
ROM boards, MIDI interfaces, digitisers, 
controllers for scanners, SCSI interfaces, 
direct laser printer controllers and 
external dise buffers. We will look briefly 
at the functions of these below. Other 
expansion cards include teletext adaptors 
(see the review elsewhere in this issue for 
further information) and genlock boards, 
which are necessary if you wish to 
synchronise video signals from the 
Archimedes with external video sources, 
for example if you are superimposing 
computer graphics onto video recordings. 


VO PODULES 

One of the strengths, and indeed selling 
points, of the original BBC micro was the 
range of facilities provided to interface to 
the external world. This was done by 
providing both analogue and digital two- 
way ports, which could be used for 
controlling electronic equipment, reading 
measurements etc. The Arc was not 
provided with these ports, but a number of 
1/O podules have appeared which aim to 
provide Arc owners with the same 
facilities. Generally speaking, commercial 
software written for the Arc will not be able 
to make use of these ports unless it has 
been specifically designed to do so, but if 
you are writing your own, or you are using 
one of the BBC emulators with correctly 
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written software, you will be able to run 
control applications and so on. 


ROM BOARDS 

Another major feature of the BBC 
micro was the ability to run software from 
sideways ROMs. In the early days of the 
Archimedes, this tradition was 
maintained with the release of a couple of 
ROM boards. However, since ROM-based 
software on the Arc has to be downloaded 
into RAM before use, it is just as easy to 
run software from disc, and so the concept 
never caught on. 


A full width expansion card 


MIDI 

MIDI stands for Musical Instrument 
Digital Interface, and has become an 
industry standard in the music world. The 
MIDI standard defines a kind of language 
by which electronic musical instruments 
can talk to each other. In much the same 
way as ASCII codes can transfer text from 
one machine to another, so MIDI can 
transfer information about musical notes 
and other relevant details between 
instruments. Thus a computer such as the 
Arc, with a music software package 
installed and a MIDI interface fitted, can 
become the nerve centre of a powerful 
electronic music system, creating and 
editing music, and _ controlling 
instruments. The heart of a MIDI podule 
is the ROM which performs the necessary 
coding and decoding. Communication with 
the outside world is via a serial interface. 


DIGITISERS 

A video digitiser provides the means to 
input video images (e.g. from a video 
camera or recorder) into the computer. A 


typical digitiser board contains complex 
circuitry including a large amount of RAM 
and an analogue-to-digital converter. It 
grabs an image one frame at a time from a 
standard video signal and stores it in the 
board’s RAM. From here it may be read by 
the Arc via the podule interface, then 
manipulated by the controlling software, by 
perhaps changing the colour balance, 
reversing the colours, scaling the image and 
so on, and displayed on the screen. Images 
thus captured can be saved as sprites and 
later imported into other applications, such 
as a DTP document. Armed with a video 
camera and a digitiser board, therefore, you 
can include real images in your documents 
at the click of a button. 


SCANNERS 


A scanner is similar in many respects 
to a digitiser, in that it inputs an image 
into the computer’s memory, which can 
then be stored as a sprite. However, the 
scanner, as its name might suggest, is 
designed to scan an existing 2- 
dimensional picture and send the picture 
information to the Arc as a series of bits. 
Scanners may be either hand-held, in 
which case they are dragged steadily 
across the document to be scanned, or flat- 
bed types, where the document is 
stationary and a motorised scanning 
device is moved across it. Inside a scanner 
is a light source (typically a row of LEDs) 
which illuminates one strip of the 
document at a time. The illuminated 
image passes through an arrangement of 
lenses and mirrors to be focused on a 
light-sensitive device. This converts the 
image into a stream of pulses which are 
then sent to the computer. In this way, the 
image is re-created from the sequence of 
bits. Initially all scanners were 
monochrome devices, but more recently 
colour scanners have begun to appear on 
the market. 


SCSI INTERFACES 

SCSI (pronounced Scuzzy) stands for 
Small Computer Systems Interface. It is an 
industry-standard data-transfer interface 
which has been in use for some time on 
other computer systems, and is often used 
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by hard disc drives. On the Archimedes, it 
is more common to use an Acorn ST506 
interface for hard drives - this is built into 
the 400 series and can be supplied as a 
podule for other machines. Nevertheless, 
SCSI drives are widely available for the Arc 
(up to 512 Mbytes capacity compared with a 
maximum of 47 Mbytes with the ST506), 
and many other devices are designed with a 
SCSI interface, including tape streamers, 
optical drives, and the new CD-ROM drives 
which have just appeared on the market. 
Once you have a SCSI interface in your 
computer SCSI devices can be daisy- 
chained, giving you instant access to a 
potentially huge data storage base from just 
one interface. Another big advantage of 
SCSI is its speed - typically 650 Kbytes/sec 
with a high capacity hard drive. 


DIRECT LASERS 

In the last couple of months a new 
concept in printing has arrived on the 
Archimedes market - the direct laser 
printer. This uses the processing power of 
the Arc, controlled by an expansion card, to 
prepare an image and then send it directly 
to the print engine, which no longer needs 
to be an intelligent (and thus expensive) 
piece of equipment. Besides the cost 
advantages, this approach offers an 
enormous increase in speed over 
conventional printing methods. It works 
somewhat like a scanner in reverse: the 
board contains video circuitry which takes a 
strip of data from the image to be printed, 
and modulates the printer’s laser beam (or 
liquid crystal shutter) directly via a high- 
speed connection between the two. This 
looks certain to be a growth area in the 
near future, as the prospect of cheap, fast 
laser printing is a very exciting one. And if 
this is not enough, already the technology 
has spawned a printer which operates at 
twice the resolution of any other laser 
printer in this sector of the market. 


DISC BUFFERS 

Like most personal computers these 
days, the Archimedes is designed to work 
with floppy dise drives which are built 
into the machine. However, many users, 
particularly those who have upgraded 
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from a BBC, have external drives which 
they would like to use with their 
Archimedes. It is not possible to connect 
an external drive directly to the Arc 
without buffering (this ensures that 
electrical levels are correctly matched 
between the two), but a number of disc 
interfaces have appeared on the market 
which contain circuitry to buffer the input 
from the external drive. Some of these are 
quite sophisticated, allowing you to use up 
to four drives, and to alter the drive 
numbers to suit your requirements; for 
example, you could use two 5.25” drives 
with the PC emulator and renumber these 
as 0 and 1 (i.e. A: and B: in PC 
terminology). Disc buffers for the A3000 
plug into the main board, as described 
earlier, but buffers for the 300 and 400 
series, although being fitted into an 
expansion card slot, normally connect 
directly to the disc drive cable and do not 
need a backplane. 


For most of these applications, there is 
a range of expansion cards on the market. 
It is not practical to list them here, but 
many have been reviewed in RISC User 
over the last three years. 


COMMANDS 

A podule manager module is supplied 
as part of RISC OS, called Podule. This 
recognises a number of commands which 
allow direct access to expansion cards. 
These were written originally to work 
under Arthur, and so are all based around 
the word “podule”, despite the subsequent 
change of name. Most of these will only be 
of use to programmers, but the command 
*Podules is useful, as it will tell you which 
expansion cards are installed in your 
Archimedes, using the format Podule n: 
<Description>, where n is the podule slot 
(i.e. 0-3). For example: 

Podule 0: Midi podule 

Podule 1: No installed podule 

Podule 2: No installed podule 

Podule 3: Scavenger 


If the Podule module is unplugged, you 
will not be able to use these commands, 
nor will it be possible for any podules in 
the machine to be initialised. RY 
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These CJE Micro's memory upgrades provide your A310 
with either 2Mb or 4Mb of RAM. The 2Mb version can have 
an additional 2Mb of RAM added at any time, giving 4Mb. 


Unlike some RAM upgrades for the A310, the CJE Micro's 
design is NOT NEW, It has been available for many 
months, and built up a record for reliability that is second to 


The No. 1 Memory Upgrade For The A310 


These memory boards are fully ARM3 
compatible, and may be used with both 
2 and 4 slot backplanes. A technical 
leaflet is available which provides full 
installation details, and covers the use of 


none. "We have found them to be excellent.” Beebug retail. 


The extra memory is functionally the same as that in a 
400/1 series computer. 


larger OS ROMs. Ring (0752) 847286 
for your free copy. 


Prices of these boards including VAT 


ide a fast ient i i ice. ; 
IFEL provide a fast and efficient installation service. For and overnight carriage both ways are; 


example, a machine collected from you on Monday will 
normally be returned the following Wednesday. 


Ring (0752) 847286 to book your upgrade or for further 
details. 


2Mb £375. 4Mb £595. 


A3000 OWNERS!! 


Announcing the new low power 2Meg/4Meg RAM board....... 


At last you can have 4Mb of RAM without the risk of 
overloading your A3000’s power supply. Because whereas 
most 4Mb RAM upgrades for the A3000 use about 26 chips. 
ours needs just eight. Clearly this reduces the load on the 
power supply, and generates much less heat. The size of the 
board is a mere 47mm by 179mm, and will not interfere 
with any other upgrades, 


3) As a bare board, You can obtain the RAM chips yourself 
and plug them into the turned-pin sockets on the board. 


Installation does not involve soldering, and unlike some 
memory boards, no soldering is needed when upgrading 
from 2Mb to 4Mb, 


Introductory prices - until October 31st 
The board is available in three forms; 


1) As a 2Mb upgrade. This gives your A3000 a total of 2Mb 
of RAM, but at any time you may upgrade it to 4Mb without 
soldering. 

2) As a 4Mb upgrade. The ultimate, giving a massive 4Mb 
of usable RAM. 


1) 2Mb RAM board 
2) 4Mb RAM board 
3) Bare board 


Money-back guarantee. All prices inclusive of VAT. 


400/1 series General hardware 
ARM3 (30MHz) £550 
chien £70 MEMC la £59 
2Mb RAM £140 4-slot backplane with fan (for A310) £69.95 
3Mb RAM £190 Oak 45Mb SCSI disc including card £535 
Oak 80Mb SCSI disc including card £820 
We can supply a range of hard discs 32K RAM chips tor RAM/ROM podule £13.50 


from 20Mb up to 512Mb. Prices from 
only £210 including VAT. 


(Unlike cheaper designs, our backplane is a true 4- 
| layer board as fitted to the 400/I series) 


Prices include VAT. You can 


| Software | order by Access or Visa, and IFEL 
| Impression £135 Many more items available. official orders welcome. EN 3% Upland Drive 
Pipedream3 £140 Please ask for our free price RAM prices are constantly Derriford 
First Word + £82 list. varying. Phone for our best — Plymouth PL6 6BD 
PC Emulator £ 98 oe sales (0752) 847286 


by Lee Calcraft 


A. you will be aware, if you hold down 
the Select or Adjust button while pointing 
to an icon within a directory viewer, a 
dotted rectangle appears around the icon, 
and this may be dragged across the 
Desktop. Using this technique you can 
deposit the icon in a new directory viewer 
by releasing the mouse button, and it will 
be copied into that directory. 


application 
pathname of objects dragged to it 


Icon dragging has many uses within 
the Desktop, the most common of which 
are loading, saving and copying files. All 
such dragging operations are handled by 
the Wimp via the Wimp messaging 
system, which allows communication 
between tasks. This comprehensive and 
flexible system is inevitably complex, and 
we will edge our way into it selectively 
through the use of examples, rather than 
attempt to present it in its entirety. 


The messaging system operates, like 
all good things, through the Wimp Poll, 
and uses the allied reason codes 17, 18 
and 19. We have already come across 17 
and 18 as you can see from the standard 
test program used in this series. Here, in 
response to reason codes 17 or 18 we 
simply inspect block%!16 for a zero, and if 
it is present, the task is closed down by 
setting the quit% flag to TRUE. This piece 
of code (or a close equivalent) is essential 
in any Desktop task in order to make it 
respond to the Wimp’s broadcast message 
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of imminent closedown - as generated for 
example if Ctrl-Shift-F12 is fingered by 
the user. 


EXPOSING THE MESSAGING 
SYSTEM 
We can easily view the messaging 
system in action by making a couple of 
minor changes to our faithful test 
program; and at this stage, any version of 
the program can be used. Firstly you 
should remove from the test program any 
debugging code which uses VDU4 and 
PRINT statements followed by VDU5. 
Then simply alter the line beginning: 
WHEN 17,18: 
in PROCpoll to read 
WHEN 17,18:PROCreceive 
and add the following procedure definition 
at the end of the program: 
DEFPROCreceive 
CASE block%!16 
WHEN 0:quit%=TRUE 
WHEN 3:VDU4:SOUND 1,-15,200,1 
PRINT TAB(0,0) "Data Load Message" 
TS=INKEY (100) 
PRINT TAB(0,0)SPC17:VDU5S 
ENDCASE 
ENDPROC 


WHY THE ICON BEEPS 


Last month’s article ended with a question: 
Why does clicking with the Menu button over 
the program name icon in the Info box generate 
a beep? 


The answer is that in the definition of 
PROCbuttons when responding with a beep to 
clicks over icon 1 in the main window, no test is 
made for the window handle. This was ok when 
our task only had a single window, but with two 
there can be confusion. The program name in 
the Info box appears in icon 1 of our second 
window, so clicking over this also generates a 
beep. To remedy the fault, we just need to 
verify that the window handle returned by the 
Wimp Poll is equal to whandle% before we 
make the beep. The line immediately before 
ENDCASE in DEFPROCbuttons should 
therefore read: 

WHEN block%!12=whandle% AND 
block%!16=il handle%:SOUND 1,-15,70,4 
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Now run the program, and try dragging 
an icon from a directory viewer either to the 
task’s window or to its icon on the icon bar (if 
it has one). You will see the words “Data Load 
Message” appear at the top left hand corner 
of the screen and hear a short blip. The text 
will be blanked out after a one second pause 
(during which time the Desktop will be 
frozen), in readiness for another drag. What 
is happening here is that Filer (the task 
which owns the directory viewers) is 
informing our task via the Wimp Poll 
messaging system that a drag has been 
performed whose destination is one of the 
icons or windows owned by our task. If you 
drag an icon to some other destination, 
nothing will be reported to our task, and no 
message will appear at the top of the screen. 


Now try to drag a group of icons from a 
directory viewer by using the Adjust 
button to mark a series of icons, and then 
use Select or Adjust to drag them. You will 
hear a blip for every icon in the group. 
When a multiple drag of this kind occurs, 
the Wimp returns information to the 
owner of the destination icon or window 
one object at a time. 


The information returned to the task 
in this way for single or multiple drags is 
the same, and is given in table 1. The first 
two items are self-explanatory. The data 
at R1+8 and R1+12 is used to supply a 
numeric reference to the message, and 
permits a receiving task to acknowledge 
the receipt of the message by sending back 
a message, and quoting the incoming 
reference number - see later. 


R1+0 size of block in bytes (max 256) 

R1+4 task handle of message sender 

R1+8 my_ref- the sender's reference 
for this message 

R1+12 your_ref - a previous message's 


my_ref, or 0 if not a reply 
R1+16 message action code 
R1+20 message data - the format of this 
depends on R1+16 (see Table 3) 


Table 1. Basic data block returned by the 
Wimp Poll with reason codes 17, 18 and 19. 


R1+16 contains the all-important 
action code. The first five of these are as 
follows: 


Code Meaning 
0 Message_Quit 
1 Message_DataSave 
2 Message_DataSaveAck 
3 Message_DataLoad 
4 Message_DataLoadAck 


Code zero is the most important. As we 
noted earlier, it informs a task that it 
must close down immediately. Normally 
this will have been preceded by a code 8 
pre-quit message (see the PRM page 
1255), at which point a task may protest if 
it thinks that it has data which the user 
may wish to save etc. 


Messages with action codes 1-4 are all 
concerned with the transfer of data 
between tasks. Messages with an action 
code of 1 are generated by non-filing 
system tasks when an object owned by 
them is dragged to a window or icon 
owned by another task. The receiving task 
acknowledges this by generating a 
message with an action code of 2. 
Messages with action codes of 3 and 4 are 
also used in general task-to-task 
transfers, and we will look at the way in 
which all four are used together next 
month. But the simplest use of messages 
with action codes of 3 and 4 is when an 
object is dragged from a directory viewer 
to an icon or window owned by another 
task. In this case, the Filer (the owner of 
the directory viewer) generates a message 
with an action code of 3, and the receiving 
task acknowledges this by issuing a 
message with an action code of 4. 


A FILE INFORMATION 
APPLICATION 


We can see how this works in practice 
by returning to our test program. With 
only a few alterations and additions we 
can turn it into an application which sits 
on the icon bar, and which displays the file 
type and pathname of any object dragged 
to it. To achieve this you will need a recent 
version of the test program which runs 
from an icon bar icon. There are only two 
essential alterations to make over and 
above the introduction of PROCreceive 
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mentioned earlier. The first concerns 
PROCreceive itself, which should be 
replaced with the code in listing 1. This 
now includes the subsidiary procedures 
PROCshowfileinfo and PROCiconstate. 
Secondly text2% at around line 110 should 
be DIMmed to &100 rather than &20. 
Further to this there are a number of 
“desirable” adjustments to neaten up the 
display. These are given in table 2. 


Alter: 

100 $textl%="Serial Port Status” 

to 

100 $textl%="File type" 

Alter 

110 DIM text2%$ &20:$text2%="Writeable 
Icon" 

to 

110 DIM text2% &100:$text23="Pathname" 
Alter 

260 whandle$=FNcreate (200, 200, 500, 400, 
0,0, &FFOOOOOF, "Test Window") 

to 

260 whandlet=FNcreate (200, 200, 364, 300, 
0,0,&687000002, "Test Window") 

Delete 

270 ilhandlet=FNicon 

Alter 

1140 PRINT "ICON TESTS" 

to 

1140 PRINT "FILE INFO" 

In the definition of PROCbuttons, delete 
the line which ends 
..-blockt!16=ihandle$:SOUND 1,~-15, 70,4 


HOW IT WORKS 

The section of code which does all the 
work is contained in the new procedure 
PROCshowfileinfo. This is called by 
PROCreceive if a Message_DataLoad is 
received by the task, implying that an icon 
has been dragged to an object owned by 
our task. The message block received by 
the task is depicted in table 3. block%!40 
thus contains the file type, and this is 
extracted and displayed in icon 2 of the 
task’s window (icon 1 has been removed). 
There are three special cases of file type 
returned in this block (values &1000, 
&2000 and &3000), and these are dealt 
with separately. 


R1+20 destination window handle 
R1+24 destination icon handle 
R1+28 destination x co-ordinate 
R1+32 destination y co-ordinate 


R1+36 estimated size of data in bytes 
R1+40 file type 
R1+44 full pathname, zero terminated 


Table 3. Message block for 
Message_DataLoad (action code 3) 


Next the pathname is extracted and 
placed in icon 8. The pathname is 
obtained from block%+44 as a zero- 
terminated string, and this is copied byte- 
by-byte into the dimensioned block at 
text2%, used by icon 3. This icon is 
writeable, so that by using the mouse, you 
can scroll through long pathnames. This is 
also highly appropriate for allied uses of 
Wimp messaging for Save operations, 


Table 2. Alterations to improve the look of the 
File Info application. The line numbers given 
here are only approximate, and will depend on 
which version of the program you are working 


where a filename is supplied in a 
writeable icon so that the user may edit it 
before dragging it to the directory viewer 


from, and when It was last renumbered. 


If you now run the task by double- 
clicking on its icon from a directory 
viewer, it will install its icon on the icon 
bar. Now whenever you drag a file or 
directory icon to this icon, it will open a 
window displaying the file type and full 
pathname of the dragged object. If the 
object is a directory or an application 
rather than a file, appropriate information 
will be displayed. 
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of his choice. 


The last four lines of the procedure are 
concerned with the display window. The 
call to PROCopenwindow ensures that the 
display window is indeed open. This is 
followed by a call to SYS 
“Wimp_SetCaretPosition” to place the 
caret at the end of the filename string. 
The two icons are then updated by calling 
PROCiconstate (which uses SYS 
“Wimp_SetIconState” SWI &400CD - see 
the PRM page 1211). 


53 


Mastering the Wimp 


54 


As you will appreciate, the present 
application does not actually load the 
dragged file, it merely displays 
information about it. But loading is just as 
easy. To do this the task should check that 
the file type of the dragged file is 
appropriate, then use the pathname 
(obtained from block%+44 with code 
similar to that of listing 1) to load the file 
using SYS “OS_File”. 


ACKNOWLEDGING THE MESSAGE 
Whether the task actually loads the 
file dragged to it, or responds to it in some 
other way, it should acknowledge the fact 
by sending a message back to the original 
sender of the Message_DataLoad. This is 
most likely to be the Filer, but could 
equally well be any other application. We 
can implement this very easily as follows. 


Replace the following line in the 
definition of PROCreceive 

WHEN 3:PROCshowfileinfo 
by 

WHEN 3:PROCloadack:PROCshowfileinfo 
and append the following procedure 
definition at the end of the program: 

DEFPROCLoadack 

block$!12=block$!8 


block3!16=4 
SYS "Wimp _SendMessage",17,block%,blo 
ck$!4 

ENDPROC 
HOW IT WORKS 

This procedure uses SYS 
“Wimp_SendMessage” (SWI &400E7, 
PRM page 1253) to send the 


Message_DataLoadAck acknowledgement. 
This is a message with an action code of 4. 
It will be sent to the originator of the 
Message_DataLoad message just received 
(in all probability the Filer task), and the 
originator will receive the acknow- 
ledgement in due course via its own Wimp 
polling loop. 


The data structure for Wimp_Send 
Message is exactly as described above for 
the block received with Wimp Poll reason 
codes 17, 18 and 19. Moreover the 
structure of the _ block for 


Message_DataLoad is the same as that for 
Message_DataLoadAck, so all we need to 
do to acknowledge the load message is to 
copy the my_ref into the your_ref slot 
(achieved in the first line of the definition 
of PROCloadack), insert a 4 at block%!16 
(message type), and call SYS 
“Wimp_SendMessage”. The three 
parameters of this call are as follows: 

RO the reason code (17, 18 or 19 - to be 

returned by Wimp Poll to the receiving 

task) 

R1 pointer to the message block 

R2 task handle of the destination task 

(or window handle owned by destination 

task, or 0 for a general broadcast to all 

tasks) 


We have used reason code 17 
(User_Message) to send our acknow- 
ledgement. This reason code tells the Wimp 
to ignore whether the present message is 
responded to or not by the destination task. 
Code 18 (User_Message_Recorded) differs 
only in that if the message is neither replied 
to nor acknowledged, the Wimp returns the 
message to the sender. Code 19 
(User_Message_Acknowledge) is used to 
inform the Wimp of the receipt of a message 
without generating an Acknowledge event at 
the destination task. For most purposes we 
can completely ignore reason code 19 in our 
Wimp Poll loops, and use reason code 17 for 
all outgoing messages; and in responding to 
the Wimp Poll we should always group 
reason codes 17 and 18 together as we have 
done in our test program. 


R1 is set to block%, the location of the 
message block, and we have set R2 to 
block%!4, picking up the task handle of 
the originator of the Message_DataLoad, 
and supplying it as the destination task 
handle for our acknowledgement. You will 
see that we have not entered our task 
handle into the block itself, nor have we 
supplied a “my_ref” at R1+8: these are 
both generated automatically by the 
Wimp. 


This completes our treatment of the 
handling of objects dragged from the Filer 
to our task. Next month we will look at 
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how to implement file dragging from our 
task, and in particular how to set up a 
Save box with a draggable icon. 


5000 DEFPROCreceive 
5010 CASE block%!16 OF 


5020 WHEN O:quit$=TRUE 

§030 WHEN 3:PROCloadack:PROCshowfilei 
nfo 

5040 ENDCASE 

5050 ENDPROC 

5060 : 


5070 DEFPROCshowfileinfo 
5080 SOUND 1,-15,200,1 
5090 typet=block$!40 
5100 CASE TRUE OF 


5110 WHEN type$=s1000:$textl$="Direct 
ory" 

5120 WHEN type$=42000:$text1$="Applic 
ation" 

5130 WHEN type$=43000:$textl$="Un-typ 
ed file" 

5140 OTHERWISE Stextlt="4"+STR 


MOUSE SPEED CONTROLLER 


(Volume 3 Issue 8) 

The text of this article did not make it 
sufficiently clear that the application 
must have a !Sprites file containing a 
sprite called !mouse (the same sprite as 
that shown in figure 1 in the article would 
do nicely), and not simply rely on the 
standard Acorn pale blue application icon. 
If this is not the case, you will get an error 
message “Sprite doesn’t exist at line 160”. 


Z88 TO ARC TRANSFER 
(Technical Queries, Volume 3 Issue 9) 
We have found that, in general, the 
recommended transfer speed of 9600 baud 
may prove to be unreliable. If this is the 
case, you should use 2400 baud-instead 
(the Z88 does not have a 4800 baud 
setting). 


We have also been informed by Colton 
Software that the latest version of 
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$~types 

5150 ENDCASE 

5160 at=0 

5170 REPEAT 

5180 bit=block$?(44+a3) 

5190 text2%?at=bt 

5200 a%t=1 

5210 UNTIL b%=0 

5220 text2%?a$=13 

5230 PROCopenwindow (whandle$) 

5240 SYS "Wimp SetCaretPosition", whandl 
e$,i3handle%,,,-1,a$-1 

5250 PROCiconstate (i2handle%) 

5260 PROCiconstate (i3handle%) 

5270 ENDPROC 

5280 : 

5290 DEFPROCiconstate (icons) 

5300 block’! 4=icon’ 

5310 block%!8=0:block$!12=0 

5320 SYS "Wimp SetIconState",, block’ 

5330 ENDPROC 

AU 


- POINTS ARISING + POINTS ARISING + POINTS ARISING - 


Pipedream (3.1) has an improved Z88 
comms link, and the specific problem 
referred to last month is unlikely to occur 
in future. A free upgrade is available to 
existing Pipedream users. For further 
details contact Colton Software at 149-151 
St Neots Road, Hardwick, Cambridge CB3 
7JQ, tel. (0954) 211472. 


BACKGROUND TEXT PRINTER 
(Volume 3 Issue 9) 

There should be a semi-colon at the end of 
each string sent to the printer using 
BPUT#. This applies to lines 440, 450, 
460, 760 and 1920-1970. So, for example, 
line 760 should read: 


WHEN 163: BPUT#P%, ES+"R"+CHRS (3) +"#"+ES 
+"R"+CHRS (0) ; :free$-=7 
For further information on this subject, 
see the article BPUT#...GET$# elsewhere 
in this issue. 
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MORLEY §£.L.£.C.7.R. 


A3000 £599 
410/1 £1099 
420/1 £1699 
440/1 £2099 


Learning Curve £699 


Archimedes} 


THE WORLDS 
MOST POWERFUL 
MICRO 


SPECIAL OFFER 
Buy an A3000 and get an 
extra 1MB RAM fitted for 
only £50 or a free A3000 

Analogue & User Port 
Podule. Buy a 410 and get 
an extra 1MB RAM free 


NEW IN STOCK 


ny MICROVITEC 
CUB3000 
MONITOR 
£199 
INCLUDING 
CABLES 


This is the new monitor from Microvitec that has been specially 
designed for use with all Archimedes computers. It comes 
in a rugged colour matched metal case with controls for 
brightness, contrast and volume. The picture quality is very 
good and all the required cables are included in the price. 


ARCHIMEDES PERIPHERALS 


Colour Monitor £199 
Mono Monitor £73 
A3000 

Monitor Stand £29 
User Port & Midi Pod. £49 
Serial Upgrade £19 
Econet Upgrade £49 


ARCHIMEDES 


Pipedream3 £147 
RiscOs Companion £49 
1st Word + £69 
Autodesk CAD £79 
Acorn PC Emulator £99 
Acorn Desktop Pub £149 
Clares ProArtisan £145 
Clares Artisan £29 
Clares Toolkit £34 
Clares Toolkit + £43 


The Morley Teletext Adapter 
is now available for the 
Archimedes. Advanced 
specifications, include digital 
tuning, screen dumps etc. 
Connects via the external 
podule socket or our 
Analogue/User Port £125 


300/400 SERIES 

Acorn Rom Podule £56 
2 Slot Backplane £37 
4 Slot Backplane £59 
1/0 Podule £80 
Midi Podule £65 
Second 3.5" Drive £115 


SOFTWARE 


This is a small 
selection of the 
software that we 
can supply at 
competitive prices. 
Please call for 
any item you 
require. 


TELETEXT 
THE BIGGEST joie 
SELLING ADAPTER 


Existing users of our BBC 
Teletext Adapter can have 
the unit converted to an 
Archimedes version for£35 


FURTHER INFORMATION 


Our new catalogue will be available from mid August. We 
can also supply data sheets for most products. Please call 


or write if you require any of these. 


A3000 3.5" 
SECOND DRIVE 


The kit consists of a 3.5 
inch floppy disc drive, data 
cable, power cable, metal 
case (cream coloured), an 
interface carrier board and 


The kit and assembly are 
similar to our 3.5" kit except 
the case is larger and the 
mechanism is a high quality 
TEAC 5.25" drive. The drive 
{unlike some you can buy) 
is also buffered to Acorn 
specifications so eliminating 
the possibility of damage to 
your A3000 (buffering is not 
required for an additional 3.5" 
drive}. 

£169 


full fitting instructions. 
You will be required to take 
the current drive out of the 
A3000 and replace it with 
the interface carrier board 
(unlike some add-on drives, 
you can still use your internal 
podule socket). The original 
drive then fixes in the case 
with the second drive and 
the case is connected to 
the A3000 with two cables. 
As the connectors are 
detachable, the unit can be 
easily disconnected from the 
computer if the need arises, 
£125 


A3000 5.25" 
SECOND DRIVE 


LEADS & MISC. HARDWARE 


SCART MonitorLead £8 
9 Way Msync Lead £8 
Arch Serial Lead £8 
Printer Lead £6 
2 to 1 Printer switch £20 
3 to 1 Printer switch £30 
4 to 1 Printer switch £36 
64k Printer Buffer £115 
256k Printer Buffer £199 


80 col Printer Stand £15 
132 col Printer Stand £19 
A3000 Monitor Stand £29 
Tilt & Swivel Stand £11 
Eprom Eraser £18 
Eraser with Timer £23 
5.25" Discs x 10 £5 
3.5” Discs x 10 £10 
27128 Eoroms £4.20 


CD labret Lew lwled 


MEMORY EXPANSION 


THE BEST VALUE MEMORY UPGRADES 


Unlike most other upgrades, our 1MB 
upgradeable card can be upgraded 
with another 2MB (4MB total in 
achine) at a later date for maximum 
exibility. Futhermore, our card can be 

upgraded without throwing away the 
jamory that you already have on the 

card. 


A3000 1 MB Expandable £99 
A3000 1 MB Non-Expandable £89 
A3000 3 MB Upgrade £259 
A3000 1 MB to 3 MB (free fitting) £180 
305 1/2 MB £89 
400 Series 1 MB £99 
400 Series 3 MB £249 


~ Fully compatible with all Acorn software. 
- A must for all serious Archimedes owners. 


- Can use extra RAM as a second drive. 


*** NEW PRODUCT *** 
A3000 BBC Analogue + User Port Podule 


Full specification BBC analogue and user 
port, The analogue port is accessible 
using ADVAL from BASIC5 with all 
BBC OSbyte calls supported. 

£69 


Interface software written by 
Acorn for maximum 
compatibility with the BBC. 


ARCHIMEDES HARD DISK DRIVES 


SCSI HARD 
DISK DRIVES 


INTERFACES 


A3000 SCSI Pod. £149 
300/400 SCSI Pod.£199 


ett NEW ett 
A3000 HARD DISK DRIVE UNIT 


INTERFACE 
ST506 Podule Kit £149 


DISK DRIVES 


Including ST506 Podule, 
cased drive with power 


SCSI DISK DRIVES 


Including SCS! Podule, 
drive, cable & leads. 


\ ; ' supply, cable & leads A3000 drives also 
20MB £399 include case and power 
— 40MB £499 ih 
Larger Drives POA A3000 20MB £465 


A3000 30MB £495 
A3000 40MB £575 
300/400 20MB £449 
300/400 30MB £489 
300/400 40MB £569 


Please call for prices on 
larger drives for A3000 
or 300/400 


Compatible with Acorn's ADFS. 16 bit 
interface for extra speed. Drive mounted 
in separate colour coordinated case with 
switched mode power supply and fan. 
Complies with Acorn's new 
recommendations on RF emissions. 


- Make full use of powerful RISC-OS packages. 


MORLEY 


E.L.E.C.T.R.O.N.1.C.S. L.T.D 


Morley House 
West Chirton 
North Shields 
Tyne & Wear 
NE29 7TY 


Tel (091) 257 6355 
Fax (091) 257 6373 


Shop hours: 
Sam to 5:30pm (Mon- 
Fri) Sam to 4pm (Sat) 


a 
Acorn 


We are an Acorn dealer and 
service centre. If you would 
like to have a look at the 
A3000 or any other Acorn/ 
Morley product please feel 
free to call in and discuss 
your requirements with our 
staff. 


if there is 
anything you 
require which isn't 
advertised, please 
ring for a 
competitive 
quote. 


How To Order.... 


BY POST: Enclose cheque 
made payable to MORLEY 
ELECTRONICS LTO. 


BY PHONE: By quoting your 
ACCESS or VISA card 
number. 


CARRIAGE; £1 on most 
orders. £3 on larger items, 
Hard Disks, Computers + 
Monitors £10 (carrier). 


VAT: UK customers please 
add 15% to cost incl. 
carriage. 


GOODS USUALLY 
DESPATCHED BY RETURN. 


Government end Education 
orders welcome. 


Acorn end Archimedes are 
trademarks of Acorn 


Hints & Tips... 


TOO MANY DISCS 


Alan Wrigley 

Each time you click on a drive icon, the disc 
name is added to the list currently known to 
the filer, and will remain there until it is 
dismounted or the machine is reset. 
Unfortunately there is a limit to the number of 
discs the ADFS can recognise at any one time, 
and if you exceed this you are likely to get an 
Address Exception error, followed by a Filecore 
in Use error if you subsequently try to access a 
disc. 


In order to avoid this, dismount discs before 
removing them from the drive unless you know 
you are going to use them again. It is good 
practice to do this anyway, and involves 
nothing more than clicking Menu over the 
drive icon and selecting Dismount. 


PRINTING OUT SCREEN DISPLAYS 

John Mitchell 
It is not normally possible to print out a music 
score produced by Maestro, but I have 
discovered a method of doing so on an Epson- 
compatible printer, Load Maestro, plus 
PrinterDM and the HardCopy module 
(Applications Dise 2). Use Maestro to display 
the score on the screen, then press F12 to leave 
the Desktop, and type *HardCopyMX (or RX or 
FX depending on your printer). This will print 
the contents of the screen, including the score. 
You can then return to the Desktop, scroll the 
window, and repeat the procedure for the next 
part of the score. 


DEBUGGING WIMP PROGRAMS 
David Holden 
RISC User has in the past published a number 
of suggestions for debugging Basic programs 
which run from the Desktop. Here is another, 
which makes use of the 
"Wimp_CommandWindow" call to display 
variables while the program is running. Add a 
procedure to the end of your program as 
follows: 
DEF PROCdebug 
SYS "Wimp_CommandWindow", 1 
CLS:PRINT <variable 1> 
PRINT <variable 2> 
SYS "Wimp _CommandWindow", 0 
ENDPROC 


Hints & Tips 


where <variable 1> and <variable 2> should be 
replaced by the names of the variables under 
investigation. 


At key points in the program, simply insert a 
call to PROCdebug. The window will open on 
the screen and display the variables you 
wished to see. When you click the mouse the 
window will disappear and the program will 
continue normally until the next PROCdebug. 
The PROC therefore acts like a breakpoint in a 
machine code monitor. 


MORE ON LOCAL VARIABLE QUIRKS 
Alan Wrigley 


Last month’s Hints & Tips outlined some 
quirks with local variables. It is also worth 
remembering that function and procedure 
parameters are treated as local variables, so: 

DEF PROCmyproc (A) 
has the same effect with regard to the variable 
Aas: 

DEF PROCmyproc 

LOCAL A 
Furthermore, if one of Basic’s so-called system 
variables (A% - Z% plus @%) is used as a 
parameter, this will of course also be treated as 
a local variable. Programmers who are used to 
the BBC micro environment often use system 
variables throughout programs, and it is easy 
to forget that a local A%, say, will not return a 
value to the global A%. It is good programming 
practice for all variables to be local to their 
particular function or procedure, unless they 
are specifically required to be global, and for 
meaningful variable names to be used 
everywhere. 


QUITTING AN APPLICATION 
Andrew Young 


Many users are unaware that you can quit a task 
by bringing up the Tusk display window from the 
Task Manager menu, then clicking Menu over 
the name of the task in the window. If you do this 
however, beware! As a result of limitations in the 
current RISC OS protocols, if you have unsaved 
data and choose the “yes” option to indicate that 
you wish it to be saved, then any editor, including 
Edit and Draw, will exit to the command line, 
losing the unsaved data in the process. For this 
reason it is always safer to quit an application 
from the icon bar menu, 
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Hints & Tips... Hints & Tips 


BLACK IS BLACK, BUT WHITE IS 


NOT WHITE 

Alan Wrigley 
If you use *ScreenSave to save a screen as a 
sprite, and then print it out from Paint, you 


application directory, whereupon double 
clicking on the application icon will run it. 


OLD FONTS WITH NEW FONT MANAGER 
E.W.Ayers 


may be surprised to find that any white areas 
come out slightly grey. This is because 
*ScreenSave saves a palette with the sprite, in 
which the RGB components of white are set to 
240 instead of 255. To overcome this, select the 
colour which should be white in the Colours 
window, click Menu over the sprite, select Edit 
Palette from the Paint sub-menu, click on the 
white box (which shows the true white Wimp 
colour) followed by OK, and then re-save the 
sprite. 


MORE ON CSD 
Graham Read 


Yet another way to set the Currently Selected 
Directory from the Desktop is to modify the 
TinyDirs utility (supplied on Applications Disc 
2) as follows. Open the application directory 
and load the program !RunImage. After the 
line: 

1080 OSCLI("Filer_OpenDir "+$(I%!8)) 
add: 

1081 OSCLI("Dir "+$ (I%+8) ) 


Then each time a directory is opened using the 
TinyDirs icon on the icon bar, the CSD is 
automatically set. Further directories can, of 
course, be dragged to the icon bar. 


MORE PC EMULATOR MEMORY 
Ben Avison 


If you have an Archimedes with 2Mbytes of 
memory or more and you use the PC Emulator, 
you may have found that when entering the 
emulator from the Desktop, you have very 
little memory free. This is because the Desktop 
is only allocating 640K to the emulator, 
including all that used in the emulation 
program itself. A simple way to get around 
this, and to aid quicker loading, is to create the 
following Obey file: 

WimpSlot -min 1024K -max 1024K 

Dir :4.$.PC 

Run Emulate 
Replace the directory in line 2 with the 
directory of your emulator if necessary. This 
file should be named !Run and placed inside an 
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Many users may have acquired the new outline 
fonts and font manager, but have existing files 
using the old bit-map fonts. It may not be 
generally realised that the new font manager 
will cope with the old fonts as well. I have 
changed the name of the directory holding my 
bit-map fonts to /OldFonts. Double clicking on 
this will cause the font manager to access them 
rather than the (default) outline fonts in 
directory /Fonts. 


Any application loaded onto the icon bar will 
adopt the fonts current at the time of loading, 
and will go on doing so until you quit it. This is 
so even if in the meantime you double click on 
!Fonts and load another multi-tasking 
application. The latter will use outline fonts, 
but you can go back and forth to the first 
application which will still be using the old 


fonts. Ay 


| Home & Business Programs | 
from Apricote Studios 


The Account Book 
Comprehensive small business accounts to trial balance. 
VAT Absolutely the easiest program to use, with 
neat books and hundreds of reports. No entry limits. 
"The Account Book gets first prize for both price and 
performance”- comparison of different business programs in 
Micro User-July '89, "A true user-friendly program, If you 
buy tees packepen yous etl oat be dlespiecimed Seabee: 
Oct '88 & Dec '89. Just £27.95. 

Invoice 


customer database, Invoices, Statements, Stock presets, 

Detbxor lists, Mail shot labels and loads more, £27.95. 

Purchase The Account Book and The Invoice Program 
together for £49.95. 


Personal Accounts 
10 on-line accounts, 48 income/payment headings, 20 direct 
debits. entries with the best edit, search and 
| reporting facilities. £14.95, Pull refund if you don't agree. } 


Apricote Studios 
2 Purls Bridge Farm 
Manca 
PE15 OND 
Tel: 035 478 432 for information, help or to order. 


22 Warwick Street 964.773 8632 


Prestwich 


Manchester 


M25 7HN 


NEW . = 
Alien Invasion 
from Alien Images, the games division of 
Dabs Press 


You all know the classic invaders game, but Dabs Press 
brings you a totally customisable game for the world's 
fastest micro, You can create new types of invader and 
add different scenery - you can even insert your own!! 
With sampled sound throughout, speed control and 
over 1000 password protected waves, this is the best in- 
vaders game for the Arc. 


pos ww ant <4 
23 ‘ 


PRICE £14.95 


Psion LZ: 
A Users' Guide to OPL 


The Psion Organiser hand held computer and its pro- 
gramming language - OPL, are now explained in full in 
our latest publication, by leading computer author, lan 
Sinclair. 
This book is a must for all dedicated Psion Organiser 
users and explains in detail how to get the best fom the 
various built in utilities and programming language. 
Topics covered include: 

Setting up the machine 

Stopwatch 

Notepad 

Variables 

Filing Techniques 

The PC Link 

AVAILABLE NOW 


PRICE £12.95 


Call NOW for a free catalogue containing full details of ALL our products (specify Arc or BBC). Access/Visa/ Mastercard 
accepted. Official and trade orders welcome. Prices include 15% VAT (on software) and UK postage. Foreign deduct VAT 
but add £2.50 Europe/ surface, £12 airmail. Fax orders or enquiries welcome on 061 


DFS for the Archimedes/A3000 


Now ready for immediate despatch ArcDFS is a full 
Archimedes implementation of the BBC DFS filing system, 
which allows you to read and write BBC-compatible discs 
on your Archimedes or A3000. The application will read, 
write, format, copy, delete, title and perform all other func- 
tions on 3.5" or 5.25" discs formatted in Acorn, Solidisk or 
Watford formats (single or double density). Density and 
format seeking is automatic. 

All operations can be performed from the RISC OS desktop, 
with the DFS disc appearing on the icon bar in the normal 
way, and displaying its files in a window. Alternatively, the 
facilities are all availableas'star' commands. ArcDFS is fully 
compatible with the BBC 6502 emulator. Many additional 
features are built into the system such as the ability to set up 
virtual DFS drives on an ADPS hard or floppy disc, and a 
DFS ramdisc. 


PRICE £29.95 


ARCHIMEDES FIRST STEPS 
Beginners Guide to the 
Archimedes & BBC A3000 


Thisbook is the perfect introductory guide to the Archimedes, 
to guide you through the first few months of ownership, 
acting as an easy-to-read supplement to the User Guide, 
The book describes in detail how to put the RISC OS Desk- 
top to best use, and also documents the programs on the Ap- 
plications Discs provided with the machine. 

But the book also goes beyond this and describes the sort of 
softwareand hardware additionsavailable to the Archimedes 
owner, and how to choose and install them. 

The many features of this book include: 

* Applicable to all Archimedes with RISC OS 

* Using the Desktop, RAMdisc and ADFS 

» Edit, Paint, Draw and Maestro 

* The Task Manager 

* The BBC and PC emulators 

* Hardware and software additions 

© Illustrated throughout 


AVAILABLE NOW! 
PRICE £9.95 


ONE OF OUR BEST SELLERS 


-773 8290. Callers welcome. 


Technical Queries 


FINDING SYSTEM RESOURCES 


Dear Sir, 
! wish someone would write an article in 
the simplest possible terms for beginners 
on error handling. For example, what does 
the message “System Resources not 
found” mean? 

Jesse H.Luxton 


The System Resources referred to are objects 
within the !System directory which can be 
found on Applications disc 1 supplied with 
every Archimedes. Display the director viewer 
for this disc in the Desktop, and then double 
click on its icon while holding down Shift. 
This will open the directory showing files with 
standard names like !Run, !Boot and !Sprites, 
and a folder called Modules. Double click on 
this to reveal its contents, called CLib, 
Colours and FPEmulator. CLib is the shared 
C library, which is needed and used by many 
applications, Colours is a module called 
ColourTrans to handle colour settings, and 
FPEmulator is fairly obviously the floating 
point emulator, again needed by many 
applications, 


Any applications which need these resources 
(and that mostly means compiled C programs 
like Draw, Edit etc.) expect to find them in the 
!System directory. An application will 
normally check to see if the required modules 
have already been loaded, and if not will 
attempt to load them using !System. The 
problem, which leads to the error message 
“System resources not found” occurs when the 
application does not know where to find 
!System. 


If the directory viewer for Applications disc 1 
has been opened on the screen, then RISC OS 
will have ‘seen’ its contents (and the system 
variable System$Path will have been set up 
to point to !System). When any application 
attempts to access !System, RISC OS will 
then know which disc it is on, and if 
necessary ask for that disc to be inserted in 
the drive. Hard dise systems are best 
configured so that !System is in the root 
directory. This ensures that !System will be 
‘seen’ as soon as the user double clicks on the 
drive icon and opens the directory viewer for 
the root directory. 


Some commercial applications include a copy 
of !System as part of that application, if a 
non-standard module is required (e.g. 
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ABCLib, the ABC Basic compiler library) or 
the application needs a later version of CLib 
(CLib v3.5 is needed for applications compiled 
with release 3 of the Acorn C compiler, rather 
than v1.2 supplied on Applications disc 1). 
RISC OS will always try to use the first copy 
of CLib which it has seen, and this may not 
always be appropriate to the application in 
question. The application will notify the user 
if the wrong version of CLib has been 
selected. Double clicking on a new version of 
!System will reset System$Path to that 
version, which will then become the reference 
version (until the system is reset). 


Mike Williams 
PSION-ARC TRANSFER 
Dear Sir, 
After reading your review of the Psion 
, | have a model LZ64, 


and have been amazed at the excellence 
of the product. | have had a lead made up 
for transferring files according to your 
article, and am doing the transfer using 
“FX calls and *TYPE. This works fine for 
data files, but with OPL procedures | get a 
Bad Procedure message. 

Nigel Kirby 


The problem arises from the method of 
transfer. A much safer way to transfer OPL 
procedures and data between the Organiser 
and Arc is to use the software supplied on 
RISC User disc for Volume 3 Issue 6. This 
provides options for transferring files in both 
directions, as well as for downloading 
ArcScan format files to the Organiser. The 
latter allows you to search the Index of the 
Programmer's Reference Manual using the 
Psion - a feature which I use regularly 
(though you will need the ArcScan disc to 
obtain the data for this). 


If you are using the RISC User transfer 
software, and still get a Bad Procedure 
message, it means that you have not 
constructed your procedure text file correctly 
on the Arc, To see where you are going wrong, 
write a short procedure on the Organiser 
itself, then import it to the Arc, then export it 
back again to the Psion, Assuming that this 
works correctly, you can find the problem with 
your “Bad Procedure” by comparing it on the 
Are with the one imported from the 
Organiser. 

Lee Calcraft ay 
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ARE YOU GOOD ENOUGH? 


As the leaders in software for the Archimedes range of computers, CLARES 
MICRO SUPPLIES are looking to extend our range even further. We are 
looking for people who are as excited by the Archimedes as we are. 


lf you have written any programs, completed or not, then we would like 
to hear from you. 


If you have any ideas for programs and have the ability fo execute the 
ideas then we want to hear from you. 


lf you have the ability to program the Archimedes but not the ideas to 
program then we want to hear from you. 


Programs can be written in any language as long as they perform their 
stated task. Many of our programs contain large chunks of BASIC with 
ARM code in the areas that it is needed. BASIC on the Archimedes is a 
very powerful language and we do not attach any snob value fo its use. If 
your program does what is meant to do then thats all we are interested in. 
Why not join the top team on the Archimedes. You get the support of our 
in-house team, privileged access through us to Acorn and invitations to 
our informal programmers seminars. 


The most important point is that you will be earning top royalty rates of if 
you prefer we will purchase your program outright. 


Please write, in confidence, to Mr. D. Clare at: 


Clares Micro Supplies, 
98 Middlewich Road, 
Northwich, 
CHESHIRE CW9 7DA 


lf you have a program either complete or in development then please 
enclose a copy for our evaluation. 


To protect yourself we advise that you lodge a copy of the program with 
your bank or solicitor BEFORE you send us a copy. You can then prove 
that your program pre-dates anything that we have. 


Act today and become part of the leading software team producing 
software for the worlds fastest micro. 


Postbag 


SIMPLICITY IS A VIRTUE 


In the June RISC User (Volume 3 Issue 7), a 
letter was printed from a Mr.I.Clarke who 
claimed that there was little material for 
beginners in RISC User. I heartily endorse his 
comments. I am not a beginner, and have 
taken BEEBUG from the first issue. However, 
RISC User has become a ‘Book for Boffins’, 
and I fear that in time it will become just a 
trade magazine. Gone are the simple 
straightforward ways of doing things. The 
wretched Desktop is invoked on every possible 
occasion to make matters more involved. 


I do realise that it is right to cater for boffins, 
but not to devote the whole of the magazine to 
them - there are more ordinary people 
around. Whenever possible, simplicity is a 
virtue. Please come down from the clouds 
and plant your feet firmly on the ground. 
Arthur Cantrill 


It is a fact of life that the Archimedes is a 
powerful and complex machine and nothing we 
can say or do will alter that. It is not merely a 
BBC micro with stereo sound and more 
colours. The function of the Desktop is to make 
life as easy and as intuitive as possible for 
users of the system (witness the success of 
the Apple Macintosh which pioneered the 
desktop approach). 


We try to cater for the whole spectrum. We are 
well aware of the needs of less technically 
minded readers, and indeed articles like Into 
the Arc are specifically aimed at beginners, 
and there are many other short programs and 
items in the magazines which take a simple 
and basic approach. We shall do our best to 
cover all aspects of this excellent machine for 
our readers; and readers’ views form a very 
important contribution to our future planning for 
RISC User. 


BEEBUG PROGRAMS ON THE ARC 


As a RISC User subscriber I also get BEEBUG 
magazine monthly, and have come to value 
some of the programs therein, especially those 
dealing with Chaos, Fractals and the like. 


Recently I keyed in the Turmite program 
from BEEBUG, but found it could affect my 
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Are quite severely. Ctrl-Break led to a total 
loss of control over the monitor, and half a 
sleepless night went by before I realised that, 
rather than having had its video chips 
blown, the Arc must have been reconfigured 
to a mode it could not support. 


No doubt Cirl-Break was not to be used with 
the program in question. However, as the Arc 
seems, in general, able to handle those 
programs (as they are not specifically 
designed to work only on the earlier 
machines) it would be helpful if due mention 
could be made of the need to modify where 
necessary, or to proceed with caution. 
D.A.A.Fagandini 


We do not specifically consider the possibility 
of Archimedes owners typing in programs from 
BEEBUG when compiling that magazine, but 
we do know from our own experience that 
many of these programs will run on an Arc, 
and often much faster. Thus many animations 
will benefit from the greater power of the 
Archimedes, though games can become 
unplayable as a result. 


However, it is highly unlikely that a BEEBUG 
program would affect an Arc in the way 
described, and we have run the program 
referred to ourselves on an Arc with no ill 
effects whatsoever. Should a situation arise 
again in which Ctrl-Break seems ineffective, 
we suggest you try Ctrl-Reset as this will 
overcome almost any unwelcome 
configuration. Since BEEBUG readers like to 
feel that ‘their’ magazine is devoted to the BBC 
micro (and Master series) we are unlikely to 
include additional information there for Arc 
users. Most programs written in Basic which do 
not directly address memory or use 6502 
machine code should work on an Arc without 
further ado. 


Another reader, Mr.Leigh, has also suggested 
that we offer compilations on disc of the best of 
the programs published in BEEBUG to run on 
the Arc. However, we believe that our not 
unlimited resources are best concentrated on 
programs (and articles) which develop the 
more sophisticated capabilities of the 
Archimedes. 

AY 
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MIRESSI ION 


completely new, reduced feature, 

version of the popular Impression DTP 

program. Designed for those who want 
the best in word processing and who want to take 
the first steps into DTP. 
Special emphasis is placed on ease of use, and 
ease of learning. It forms the ideal introduction 
to DTP and can be the stepping stone from word 
processing to DTP. It includes all the traditional 
word processing functions, and more, alongside a 
range of powerful DTP facilities 

Enhanced word processing 
Optional system font screen editing for maximum 
legibility + Multiple documents in memory at 
once + Ruler operation « True WYSIWYG + 
Printer drivers for all popular dot-matrix printers 
offering fast, character mode printing + On screen 
bold, italic, underline + Format as you type + 
Spell check with check-as-you-type, user diction: 
aries etc. (Based on SpellMaster) + Super fast 
cut/copy/paste of text and graphics - even 
between documents + Multi-line headers and 
footers + Plenty of keyshort cuts for fast editing, 
many Inter Word & Wordwise compatible + Loads 
FirstWord Plus, Inter Word and Wordwise files 
However, unlike other word processors, 
Impression Junior is also a very powerful DTP 
program offering - 

Desk Top Publishing 

Full use of outline fonts, scalable to any size and 
position on the page. + Frame based DIP opera 


tion giving simple control over the positioning of 


graphics or text + RISC OS printer drivers for 
highest possible quality output for all popular 
printers + On screen floating rulers for text 
formatting and page rulers for frame positioning 
+ Sprite or Draw graphics at any position with 
instant scale and crop + Scale view of the page 
from 10% to 900% + A collection of frame 
border styles + Automatic text flow around frames 
+ Supplied with 12 outline fonts licenced from 
Acorn + Very flexible print options - any scale, 
upright or sideways etc 

Other features 
Upgradeable to Impression: Junior owners can 
upgrade to the full blown Impression for the 
difference in price, at any time + File compatible 
with Impression, and documents saved with 
Impression Junior are directly loadable into other 
versions + Fully RISC OS compatible with direct 
links to !Draw, !Paint & other applications + 
Ideal for 1Mbyte machine owners + No hardware 
protection. 
The manual includes a step-by-step introduction 
to Impression Junior. The tutorials take you, 
from scratch, through the creation of simple 
letters, multi-page documents and typical DTP 
type pages. The package also includes the highly 
acclaimed‘ DTP at a glance’ book. 
Uf you have been overtohelmed by the capabilities 
of other DTP programs, or simply don't require 
all the powerful features these may provide, then 
Impression Junior is the answer. And remember 


it is part of a family of products so that as your 


enhanced word processing 
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experience grows and your requirements evolve Ask for details of 

there is always a version of Impression to suit. educational discounts 
Created by the team that produced Wordwise, and site licences. 
InterWord and Impression, Junior is at last a 
realistic alternative to First Word Plus, yet adds a 
whole new dimension of DTP possibilities. aut mma 


RRP £89.95 +VAT (£103.44) 


Se) 


Computer Concepts Ltd 
Gaddesden Place, Hemel Hempstead, Herts. HP2 6EX. Tel 0442 63933 Fax 0442 231632 


All details subject to change. 
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The Best Solution 
Ovation provides a single solution to all of your desktop 
publishing and word processing needs. Combining the most 
useful and powerful features from DTP systems costing much 
more, you will find Ovation has just about everything you 
could want. Ask your dealer fora demonstration— you won't 
be disappointed. 


Text Editing 
Text may be typed in straight away just like a word 
processor, without the nced for any complicated frames or 
styles. When a page is full, text will simply flow onto the next 
page. In addition you may add any number of frames to the 
page, each with its own ‘story: Frames may be linked together 
causing the ‘story’ to flow from frame to frame 


Adding Style 

A ‘style’ is the font, size, justification, leading, indent etc 
of a piece of text, Ovation allows any number of styles to be 
defined, named and then 
applied to paragraphs at were’ 
the press of a key. Styles Ovetion: Intraduct 
may be re-defined at any 
time, and the changes will 
automatically flow through 
the entire document. 
In addition, local styles 
may be applied to any 
highlighted block by simply selecting the font, size, style and 
format from the menus. 


Frame Handling 

Ovation has many advanced frame features, such as 
linked text frames with auto-flow, repel text, definable frame 
borders and a step-and-repeat facility. Unique on the 
Archimedes, is our parent/child system for frames and lines 
This system allows you to copy and paste frames with 
embedded child frames and lines, as single items. This allows 
diagrams, forms, tables etc. to be copied or moved with ease. 


The Instinctive DTP 


Ovation is supplied with a tutorial and complete user 
guide, although you probably won't need to refer to it very 
often. Ovation makes full use of the RISC OS multi-tasking 
environment to provide a formidable array of features that 
are easy to learn and instinctive to use. A quick reference 
card is also included, which lists all the keyboard and mouse 
short cuts. 


Available from BEEBUG for the Archimedes and A3000 


Other Features 


® Multi-tasking/multi-documents @ No hardware protection 

@ Full WYSIWYG display with variable view 

@ Fast built-in spelling 
checker (requires 2Mb) 

®@ Printer drivers for Epson, 
PostScript, LaserJet, and 
Integrex printers 

® Import Draw and Sprite 
files. Features include: 
scale, crop, fit-to-frame 


® Master pages for cach chapter 

® Cut/copy/paste using clipboard 

® Multiple columns @ Find and replace 

® Automatic headers and footers 

® Supplied with 4 outline fonts (13 faces) 

® Variable (& fractional) font sizes Ipt to 500pt 
® Supports coloured text, frames and borders 
® Stylesheets and customised start-up 

® Definable frame borders 

® Linkable text frames 

© Supplied with full range of clipart 


®@ Variable size, style and colour lines 
Manual and auto hyphenation (requires 2Mb) 
And much, much more. 


. , 
Excellent Value 
At only £99 plus VAT Ovation represents better value for 
moncy than any other DTP on the Archimedes/A3000. 
But don’t be mislead by price. We are confident you will be 


impressed, and offer a full refund if not completely satisfied. 
Educational discounts and site licences are available 


Only £99. 00 


(+£3 carriage) plus VAT 


Available directly from Beebug or from your local dealer. 
Please phone for a full specification. 


Beebug Ltd., 
117 Hatfield Rd, St. Albans, # FE T] 
Herts, AL1 4JS 


Tel: (0727) 40303 Fax: (0727) 60263 
If you wish to order directly, cheques, credit cards and 
Official orders are all welcome. 


